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)
  },
  "adGroupInventoryControl": {
    object (AdGroupInventoryControl)
  },
  "adSource": enum (AdSource),
  "creativeAssignments": [
    {
      object (CreativeAssignment)
    }
  ]
}
שדות
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)

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

enum (AdSource)

אופציונלי. המקור של המודעות בקבוצת המודעות הזו. השדה הזה משמש רק כשמודעות נוצרות באופן אוטומטי ממקור נתון.
creativeAssignments[]

object (CreativeAssignment)

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

אפשר להקצות את השדה הזה רק אם הערך של adSource הוא AD_SOURCE_DV360_CREATIVE.

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.

AdSource

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

טיפוסים בני מנייה (enum)
AD_SOURCE_UNSPECIFIED לא צוין או לא ידוע. ברירת המחדל היא מקור מודעות רגיל.
AD_SOURCE_DV360_CREATIVE המקור הוא קריאייטיב ב-DV360.

CreativeAssignment

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

ייצוג ב-JSON 
{
  "creativeId": string
}
שדות
creativeId

string (int64 format)

חובה. המזהה של הקריאייטיב ב-Display & Video 360 שהוקצה לקבוצת המודעות.

Methods

bulkEditAssignedTargetingOptions

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

bulkListAssignedTargetingOptions

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

create

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

delete

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

get

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

list

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

patch

 מעדכנת קבוצת מודעות קיימת.