REST Resource: advertisers.youtubeAdGroups

Zasób: YoutubeAdGroup

1 grupa reklam w YouTube powiązana z elementem zamówienia typu YouTube i sieć partnerów wideo Google.

Zapis 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)
  }
}
Pola
name

string

Nazwa zasobu grupy reklam.
advertiserId

string (int64 format)

Unikalny identyfikator reklamodawcy, do którego należy grupa reklam.
adGroupId

string (int64 format)

Unikalny identyfikator grupy reklam. Przypisany przez system.
lineItemId

string (int64 format)

Unikalny identyfikator elementu zamówienia, do którego należy grupa reklam.
displayName

string

Wyświetlana nazwa grupy reklam.

Musi być zakodowany w formacie UTF-8 i mieć maksymalny rozmiar 255 bajtów.
youtubeAdIds[]

string (int64 format)

Identyfikatory zasobów [youtube_ad_group_ad][] powiązanych z grupą reklam.
adGroupFormat

enum (YoutubeAndPartnersAdGroupFormat)

Format reklam w grupie reklam.
biddingStrategy

object (YoutubeAndPartnersBiddingStrategy)

Strategia ustalania stawek stosowana przez grupę reklam.
entityStatus

enum (EntityStatus)

Określa, czy grupa reklam może wydawać budżet i licytować zasoby reklamowe.

Jeśli nadrzędny element zamówienia grupy reklam nie jest aktywny, grupa reklam nie może wydawać budżetu, nawet jeśli jej własny stan to ENTITY_STATUS_ACTIVE.
targetingExpansion

object (TargetingExpansionConfig)

Ustawienia rozszerzenia zasięgu kierowania grupy reklam.

Ta konfiguracja jest dostępna tylko wtedy, gdy do grupy reklam przypisany jest odpowiedni kierowanie na listę odbiorców.
productFeedData

object (ProductFeedData)

Ustawienia pliku danych o produktach w tej grupie reklam.

YoutubeAndPartnersAdGroupFormat

Format grupy reklam w YouTube.

Wartości w polu enum
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_UNSPECIFIED Wartość formatu nie jest określona lub jest nieznana w tej wersji.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_IN_STREAM Reklamy In-Stream.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_VIDEO_DISCOVERY Reklamy In-Feed.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_BUMPER Bumpery reklamowe.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM Reklamy In-Stream niemożliwe do pominięcia.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_AUDIO Reklamy audio In-Stream niemożliwe do pominięcia.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_ACTION Reklamy elastyczne w kampaniach wideo zachęcających do działania.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_REACH Grupy reklam o skutecznym zasięgu, w tym reklamy In-Stream i bumpery reklamowe.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_MASTHEAD Reklama w banerze masthead wyświetlana w górnym polu na stronie głównej YouTube.

ProductFeedData

Szczegóły pliku danych o produktach.

Zapis JSON 
{
  "productMatchType": enum (ProductMatchType),
  "productMatchDimensions": [
    {
      object (ProductMatchDimension)
    }
  ],
  "isFeedDisabled": boolean
}
Pola
productMatchType

enum (ProductMatchType)

Sposób, w jaki plik danych o produktach wybiera produkty.
productMatchDimensions[]

object (ProductMatchDimension)

Lista wymiarów służących do dopasowywania produktów.
isFeedDisabled

boolean

Czy w pliku danych o produktach jest wyłączona opcja wyświetlania produktów.

ProductMatchType

Typy sposobów dopasowywania produktów.

Wartości w polu enum
PRODUCT_MATCH_TYPE_UNSPECIFIED Nieokreślony lub nieznany.
PRODUCT_MATCH_TYPE_ALL_PRODUCTS Wszystkie produkty są dopasowane.
PRODUCT_MATCH_TYPE_SPECIFIC_PRODUCTS Wybrane są konkretne produkty.
PRODUCT_MATCH_TYPE_CUSTOM_LABEL dopasowywać produkty na podstawie ich etykiet własnych,

ProductMatchDimension

Wymiar używany do dopasowywania produktów.

Zapis 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.
}
Pola
Pole unii dimension. Wymiar i wartość, na podstawie których ma być dopasowywany produkt. dimension może być tylko jednym z tych elementów:
productOfferId

string

Identyfikator oferty produktu, który ma być dopasowany do produktu o tym samym identyfikatorze oferty.
customLabel

object (CustomLabel)

Etykieta własna dopasowywania do wszystkich produktów z tą etykietą.

CustomLabel

Klucz i wartość etykiety niestandardowej.

Zapis JSON 
{
  "key": enum (CustomLabelKey),
  "value": string
}
Pola
key

enum (CustomLabelKey)

Klucz etykiety.
value

string

Wartość etykiety.

CustomLabelKey

Klucz etykiety własnej

Wartości w polu enum
CUSTOM_LABEL_KEY_UNSPECIFIED Nieokreślony lub nieznany.
CUSTOM_LABEL_KEY_0 Indeks klucza 0.
CUSTOM_LABEL_KEY_1 Indeks klucza 1.
CUSTOM_LABEL_KEY_2 Klucz indeks 2.
CUSTOM_LABEL_KEY_3 Kluczowy indeks 3.
CUSTOM_LABEL_KEY_4 Kluczowy indeks 4.

Metody

bulkListAdGroupAssignedTargetingOptions

 Wyświetla przypisane opcje kierowania w przypadku wielu grup reklam w YouTube według typów kierowania.

get

 Pobiera grupę reklam w YouTube.

list

 Wyświetla listę grup reklam w YouTube.