REST Resource: advertisers.adGroups

משאב: AdGroup

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

ייצוג JSON 
{
  "name": string,
  "advertiserId": string,
  "adGroupId": string,
  "lineItemId": string,
  "displayName": string,
  "adGroupFormat": enum (AdGroupFormat),
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "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 בייטים.
adGroupFormat

enum (AdGroupFormat)

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

object (BiddingStrategy)

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

enum (EntityStatus)

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

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

object (TargetingExpansionConfig)

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

object (ProductFeedData)

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

AdGroupFormat

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

טיפוסים בני מנייה (enums)
AD_GROUP_FORMAT_UNSPECIFIED לא צוין ערך פורמט או שהוא לא ידוע בגרסה הזו.
AD_GROUP_FORMAT_IN_STREAM מודעות וידאו In-stream.
AD_GROUP_FORMAT_VIDEO_DISCOVERY מודעות בגוף הפיד.
AD_GROUP_FORMAT_BUMPER מודעות באמפר.
AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM מודעות וידאו In-stream שלא ניתן לדלג עליהן.
AD_GROUP_FORMAT_AUDIO מודעות אודיו In-stream שלא ניתן לדלג עליהן.
AD_GROUP_FORMAT_RESPONSIVE מודעות רספונסיביות.
AD_GROUP_FORMAT_REACH קבוצות של מודעות לשיפור פוטנציאל החשיפה, כולל מודעות וידאו In-stream ומודעות באמפר.
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

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

get

 הפונקציה מקבלת קבוצת מודעות.

list

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