REST Resource: advertisers.adGroups

משאב: קבוצת מודעות

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

ייצוג ב-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

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

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

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

טיפוסים בני מנייה (enum)
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

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

טיפוסים בני מנייה (enum)
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.

Methods

bulkListAdGroupAssignedTargetingOptions

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

get

 מקבלים קבוצת מודעות.

list

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