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 
{

  // Union field youtube_asset can be only one of the following:
  "locationAssetFilter": {
    object (LocationAssetFilter)
  },
  "affiliateLocationAssetFilter": {
    object (AffiliateLocationAssetFilter)
  },
  "sitelinkAsset": {
    object (SitelinkAsset)
  }
  // End of list of possible types for union field youtube_asset.
}
שדות
שדה איחוד youtube_asset. הנכס ב-YouTube. הערך youtube_asset יכול להיות רק אחד מהבאים:
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 שמקושרים למשאב הנתון.