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)
  },
  "adGroupInventoryControl": {
    object (AdGroupInventoryControl)
  }
}
שדות
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 ו-demandGenBid.
entityStatus

enum (EntityStatus)

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

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

object (TargetingExpansionConfig)

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

object (ProductFeedData)

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

object (AdGroupInventoryControl)

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

AdGroupFormat

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

טיפוסים בני מנייה (enum)
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.
AD_GROUP_FORMAT_DEMAND_GEN מודעות ליצירת ביקוש.

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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "productOfferId": string,
  "customLabel": {
    object (CustomLabel)
  }
  // End of mutually exclusive fields.
}
שדות
המאפיין והערך שלפיהם יתבצע החיפוש של המוצר. הרשימה הבאה כוללת שדות שאי אפשר להשתמש בהם בו-זמנית. בכל תשובה יוגדר לכל היותר אחד מהשדות:
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.

AdGroupInventoryControl

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

ייצוג ב-JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "adGroupInventoryStrategy": enum (AdGroupInventoryStrategy),
  "selectedInventories": {
    object (SelectedInventories)
  }
  // End of mutually exclusive fields.
}
שדות
הכלים לניהול שטחי פרסום של קבוצת המודעות. הרשימה הבאה כוללת שדות שאי אפשר להשתמש בהם בו-זמנית. בכל תשובה יוגדר לכל היותר אחד מהשדות:
adGroupInventoryStrategy

enum (AdGroupInventoryStrategy)

אסטרטגיית המלאי.
selectedInventories

object (SelectedInventories)

מלאי שטחי הפרסום שנבחר.
סוף השדות הבלעדיים.

AdGroupInventoryStrategy

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

טיפוסים בני מנייה (enum)
AD_GROUP_INVENTORY_STRATEGY_UNSPECIFIED לא צוין או לא ידוע.
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_AND_DISPLAY_NETWORK_INVENTORY קבוצת המודעות מצורפת לכל מלאי שטחי הפרסום של Google ושל רשת המדיה.
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_INVENTORY קבוצת המודעות מופעלת בכל מלאי שטחי הפרסום של Google.

SelectedInventories

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

ייצוג ב-JSON 
{
  "allowYoutubeStream": boolean,
  "allowYoutubeShorts": boolean,
  "allowYoutubeFeed": boolean,
  "allowDiscover": boolean,
  "allowGmail": boolean,
  "allowGoogleDisplayNetwork": boolean
}
שדות
allowYoutubeStream

boolean

האם קבוצת המודעות מוגדרת להצגת מודעות במלאי שטחי הפרסום של מודעות וידאו In-stream ב-YouTube.
allowYoutubeShorts

boolean

האם קבוצת המודעות הופעלה במלאי שטחי הפרסום ב-YouTube Shorts.
allowYoutubeFeed

boolean

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

boolean

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

boolean

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

boolean

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

Methods

bulkEditAssignedTargetingOptions

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

bulkListAssignedTargetingOptions

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

create

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

delete

 מחיקת קבוצת מודעות.

get

 מאחזר קבוצת מודעות.

list

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

patch

 עדכון של קבוצת מודעות קיימת.