REST Resource: advertisers.youtubeAdGroups

משאב: YoutubeAdGroup

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

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

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

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

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

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

get

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

list

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