REST Resource: advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations

משאב: YoutubeAssetAssociation

שיוך בין משאב לבין נכס ב-YouTube.

ייצוג ב-JSON 
{
  "name": string,
  "youtubeAssetType": enum (YoutubeAssetType),
  "linkedYoutubeAsset": {
    object (LinkedYouTubeAsset)
  }
}
שדות
name

string

מזהה. שם המשאב של הקישור.

לשיוכים ברמת הפריט: תבנית השם היא advertisers/{advertiserId}/lineItems/{lineItemId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations/{youtubeAssetAssociationId}.

לשיוכים ברמת קבוצת המודעות: תבנית השם היא advertisers/{advertiserId}/adGroups/{adGroupId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations/{youtubeAssetAssociationId}.

בשיוכים YOUTUBE_ASSET_TYPE_LOCATION ו-YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION: youtubeAssetAssociationId הוא המזהה של קבוצת הנכסים המקושרת, או 0 אם locationMatchingType או affiliateLocationMatchingType הם DISABLED.

לYOUTUBE_ASSET_TYPE_SITELINKשיוכים: youtubeAssetAssociationId הוא המזהה של נכס ה-Sitelink המקושר.
youtubeAssetType

enum (YoutubeAssetType)

חובה. סוג הנכס ב-YouTube שמשויך למשאב.
linkedYoutubeAsset

object (LinkedYouTubeAsset)

חובה. נכס ב-YouTube שמשויך למשאב.

YoutubeAssetType

סוגים אפשריים של נכסים ב-YouTube.

הנכסים האלה יציגו מידע נוסף לצד המודעות במהלך הצגתן.

טיפוסים בני מנייה (enum)
YOUTUBE_ASSET_TYPE_UNSPECIFIED סוג הנכס ב-YouTube לא צוין או לא ידוע בגרסה הזו.
YOUTUBE_ASSET_TYPE_LOCATION נכס מיקום.
YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION נכס לחיפוש מפיצים.

LinkedYouTubeAsset

נכס ב-YouTube שמקושר למשאב ב-YoutubeAssetAssociation.

ייצוג ב-JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "locationAssetFilter": {
    object (LocationAssetFilter)
  },
  "affiliateLocationAssetFilter": {
    object (AffiliateLocationAssetFilter)
  },
  "sitelinkAsset": {
    object (SitelinkAsset)
  }
  // End of mutually exclusive fields.
}
שדות
הנכס ב-YouTube. הרשימה הבאה כוללת שדות שאי אפשר להשתמש בהם בו-זמנית. בכל תשובה יוגדר לכל היותר אחד מהשדות:
locationAssetFilter

object (LocationAssetFilter)

מסנן נכסי מיקום.

אפשר להגדיר את האפשרות הזו רק אם הערך של youtubeAssetType הוא YOUTUBE_ASSET_TYPE_LOCATION.
affiliateLocationAssetFilter

object (AffiliateLocationAssetFilter)

מסנן של נכסים לחיפוש מפיצים.

אפשר להגדיר את האפשרות הזו רק אם הערך של youtubeAssetType הוא YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION.
סוף השדות הבלעדיים.

LocationAssetFilter

מסנן נכסים שתואם לנכסי מיקום שעומדים בדרישות להצגה.

ייצוג ב-JSON 
{
  "locationMatchingType": enum (LocationMatchingType),
  "assetSetId": string,
  "locationMatchingFunction": {
    object (LocationMatchingFunction)
  }
}
שדות
locationMatchingType

enum (LocationMatchingType)

חובה. סוג ההתאמה של המסנן הזה של נכס המיקום.
assetSetId

string (int64 format)

פלט בלבד. המזהה של קבוצת הנכסים שתואמת לנכסי המיקום שעומדים בדרישות להצגה.
locationMatchingFunction

object (LocationMatchingFunction)

אופציונלי. פונקציית ההתאמה שקובעת איך המסנן של נכסי המיקום מתאים לנכסי המיקום.

זהו שדה חובה שאפשר להגדיר רק אם הערך של locationMatchingType הוא FILTER או SELECTED_ASSETS.

LocationMatchingType

סוגי התאמה אפשריים שקובעים אילו נכסי מיקום עומדים בדרישות להצגה.

טיפוסים בני מנייה (enum)
LOCATION_MATCHING_TYPE_UNSPECIFIED סוג ההתאמה למיקום לא צוין או לא ידוע בגרסה הזו.
SELECT_ALL כל נכסי המיקום הזמינים כשירים להצגה.
FILTER נכסי המיקום שתואמים למסננים של שם העסק או התווית יכולים להופיע.
SELECTED_ASSETS רק נכסי המיקום שנבחרו יוצגו.
DISABLED אי אפשר להציג נכסי מיקום.

LocationMatchingFunction

פונקציית ההתאמה של מסנן נכסי מיקום.

ייצוג ב-JSON 
{
  "labels": [
    string
  ],
  "locationAssetIds": [
    string
  ],
  "business": string
}
שדות
labels[]

string

אופציונלי. התוויות שצריך להתאים להן.

התוויות משולבות באמצעות האופרטור הלוגי OR.

השדה הזה הוא אופציונלי, ואפשר להגדיר אותו רק אם הערך של locationMatchingType הוא FILTER.
locationAssetIds[]

string (int64 format)

אופציונלי. המזהים של נכסי המיקום שנבחרו.

חובה למלא את השדה הזה אם הערך של locationMatchingType הוא SELECTED_ASSETS.
business

string

אופציונלי. שם העסק שצריך להיות זהה לשם שמופיע במרשם.

השדה הזה הוא אופציונלי, ואפשר להגדיר אותו רק אם הערך של locationMatchingType הוא FILTER.

AffiliateLocationAssetFilter

מסנן נכסים שתואם לנכסים לחיפוש מפיצים שעומדים בדרישות להצגה.

ייצוג ב-JSON 
{
  "affiliateLocationMatchingType": enum (AffiliateLocationMatchingType),
  "assetSetId": string,
  "affiliateLocationMatchingFunction": {
    object (AffiliateLocationMatchingFunction)
  }
}
שדות
affiliateLocationMatchingType

enum (AffiliateLocationMatchingType)

חובה. סוג ההתאמה של המסנן הזה של נכס לחיפוש מפיצים.
assetSetId

string (int64 format)

פלט בלבד. המזהה של קבוצת הנכסים שתואמת לנכסים לחיפוש מפיצים שעומדים בדרישות להצגה.
affiliateLocationMatchingFunction

object (AffiliateLocationMatchingFunction)

אופציונלי. פונקציית ההתאמה שקובעת איך המסנן של הנכס לחיפוש מפיצים מתאים לנכסים לחיפוש מפיצים.

זהו שדה חובה שאפשר להגדיר רק אם הערך של affiliateLocationMatchingType הוא SELECTED_CHAINS.

AffiliateLocationMatchingType

סוגי ההתאמה האפשריים שקובעים אילו נכסים לחיפוש מפיצים עומדים בדרישות להצגה.

טיפוסים בני מנייה (enum)
AFFILIATE_LOCATION_MATCHING_TYPE_UNSPECIFIED סוג ההתאמה של מיקום המפיץ לא צוין או לא ידוע בגרסה הזו.
SELECT_ALL כל הנכסים הזמינים לחיפוש מפיצים עומדים בדרישות להצגה.
SELECTED_CHAINS אפשר להציג את נכסי המיקום המקושרים שנבחרו.
DISABLED אי אפשר להציג נכסים לחיפוש מפיצים.

AffiliateLocationMatchingFunction

פונקציית ההתאמה של מסנן נכסים לחיפוש מפיצים.

ייצוג ב-JSON 
{
  "chains": [
    {
      object (AffiliateLocationChain)
    }
  ]
}
שדות
chains[]

object (AffiliateLocationChain)

אופציונלי. מזהי הרשתות של המיקומים המקושרים שנבחרו.

חובה למלא את השדה הזה אם הערך של affiliateLocationMatchingType הוא SELECTED_CHAINS.

AffiliateLocationChain

רשת של מיקומים מקושרים.

ייצוג ב-JSON 
{
  "chainId": string
}
שדות
chainId

string (int64 format)

חובה. המזהה של רשת המיקומים של המפיץ.

SitelinkAsset

נכס Sitelink.

ייצוג ב-JSON 
{
  "assetId": string
}
שדות
assetId

string (int64 format)

חובה. המזהה של נכס ה-Sitelink.

Methods

create

 יוצרת שיוך חדש בין המשאב שזוהה לבין נכס ב-YouTube.

delete

 מוחק שיוך קיים בין המשאב שצוין לבין נכס ב-YouTube.

list

 רשימת השיוכים של נכסי YouTube שמקושרים למשאב הנתון.