REST Resource: advertisers.youtubeAdGroups

משאב: YouTubeAdGroup

קבוצת מודעות אחת ב-YouTube שמשויכת לפריט YouTube ו-Partners.

ייצוג JSON 
{
  "name": string,
  "advertiserId": string,
  "adGroupId": string,
  "lineItemId": string,
  "displayName": string,
  "youtubeAdIds": [
    string
  ],
  "adGroupFormat": enum (YoutubeAndPartnersAdGroupFormat),
  "biddingStrategy": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "entityStatus": enum (EntityStatus),
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "productFeedData": {
    object (ProductFeedData)
  }
}
שדות
name

string

שם המשאב של קבוצת המודעות.
advertiserId

string (int64 format)

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

string (int64 format)

המזהה הייחודי של קבוצת המודעות. הוקצה על ידי המערכת.
lineItemId

string (int64 format)

המזהה הייחודי של הפריט שאליו שייכת קבוצת המודעות.
displayName

string

השם המוצג של קבוצת המודעות.

חייב להיות בקידוד UTF-8 ובגודל מקסימלי של 255 בייטים.
youtubeAdIds[]

string (int64 format)

המזהים של משאבי [youtube_ad_group_ad][] המשויכים לקבוצת המודעות.
adGroupFormat

enum (YoutubeAndPartnersAdGroupFormat)

הפורמט של המודעות בקבוצת המודעות.
biddingStrategy

object (YoutubeAndPartnersBiddingStrategy)

שיטת הבידינג שבה משתמשת קבוצת המודעות.
entityStatus

enum (EntityStatus)

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

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

object (TargetingExpansionConfig)

הגדרות הרחבת הטירגוט של קבוצת המודעות.

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

object (ProductFeedData)

ההגדרות של פיד המוצרים בקבוצת המודעות הזו.

YoutubeAndPartnersAdGroupFormat

הפורמט של קבוצת המודעות ב-YouTube.

טיפוסים בני מנייה (enums)
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_UNSPECIFIED ערך הפורמט לא צוין או שהוא לא ידוע בגרסה הזו.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_IN_STREAM מודעות וידאו In-stream.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_VIDEO_DISCOVERY מודעות בגוף הפיד.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_BUMPER מודעות באמפר.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM מודעות וידאו In-stream שלא ניתן לדלג עליהן.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_AUDIO מודעות אודיו In-stream שלא ניתן לדלג עליהן.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_ACTION מודעות רספונסיביות לקמפיינים של מודעות וידאו עם קריאה לפעולה.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_REACH קבוצות של מודעות לשיפור פוטנציאל החשיפה, כולל מודעות וידאו In-stream ומודעות באמפר.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_MASTHEAD מודעה מסוג Masthead שמוצגת במשבצת העליונה בדף הבית של YouTube.

ProductFeedData

הפרטים של פיד המוצרים.

ייצוג JSON 
{
  "productMatchType": enum (ProductMatchType),
  "productMatchDimensions": [
    {
      object (ProductMatchDimension)
    }
  ],
  "isFeedDisabled": boolean
}
שדות
productMatchType

enum (ProductMatchType)

איך המוצרים נבחרים לפי פיד המוצרים.
productMatchDimensions[]

object (ProductMatchDimension)

רשימת מימדים המשמשים להתאמה למוצרים.
isFeedDisabled

boolean

אם בוטלה ההסכמה להצגת מוצרים בפיד המוצרים.

ProductMatchType

סוגי הדרכים להתאמת מוצרים.

טיפוסים בני מנייה (enums)
PRODUCT_MATCH_TYPE_UNSPECIFIED לא צוין או לא ידוע.
PRODUCT_MATCH_TYPE_ALL_PRODUCTS כל המוצרים תואמים.
PRODUCT_MATCH_TYPE_SPECIFIC_PRODUCTS נבחרו מוצרים ספציפיים.
PRODUCT_MATCH_TYPE_CUSTOM_LABEL מתאימים מוצרים לפי תוויות מותאמות אישית.

ProductMatchDimension

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

ייצוג JSON 
{

  // Union field dimension can be only one of the following:
  "productOfferId": string,
  "customLabel": {
    object (CustomLabel)
  }
  // End of list of possible types for union field dimension.
}
שדות
שדה איחוד dimension. המאפיין והערך שעליהם יש להתאים למוצר. dimension יכול להיות רק אחד מהבאים:
productOfferId

string

המזהה של המוצר שמיועד למוצר עם אותו מזהה מבצע.
customLabel

object (CustomLabel)

התווית המותאמת אישית כדי להתאים לכל המוצרים בעלי התווית הזו.

CustomLabel

המפתח והערך של תווית מותאמת אישית.

ייצוג JSON 
{
  "key": enum (CustomLabelKey),
  "value": string
}
שדות
key

enum (CustomLabelKey)

מפתח התווית.
value

string

ערך התווית.

CustomLabelKey

המפתח של התווית המותאמת אישית

טיפוסים בני מנייה (enums)
CUSTOM_LABEL_KEY_UNSPECIFIED לא צוין או לא ידוע.
CUSTOM_LABEL_KEY_0 אינדקס מפתח 0.
CUSTOM_LABEL_KEY_1 אינדקס מפתחות 1.
CUSTOM_LABEL_KEY_2 אינדקס מפתחות 2.
CUSTOM_LABEL_KEY_3 אינדקס מפתחות 3.
CUSTOM_LABEL_KEY_4 אינדקס מפתחות 4.

שיטות

bulkListAdGroupAssignedTargetingOptions

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

get

 יוצר קבוצת מודעות ב-YouTube.

list

 הצגת רשימה של קבוצות מודעות ב-YouTube.