REST Resource: advertisers.adGroups

Zasób: AdGroup

Pojedyncza grupa reklam powiązana z elementem zamówienia.

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

string

Tylko dane wyjściowe. Identyfikator. Nazwa zasobu grupy reklam.
advertiserId

string (int64 format)

Tylko dane wyjściowe. Unikalny identyfikator reklamodawcy, do którego należy grupa reklam.
adGroupId

string (int64 format)

Tylko dane wyjściowe. Unikalny identyfikator grupy reklam. Przypisany przez system.
lineItemId

string (int64 format)

Wymagane. Wartość niezmienna. Unikalny identyfikator elementu zamówienia, do którego należy grupa reklam.
displayName

string

Wymagane. Wyświetlana nazwa grupy reklam.

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

enum (AdGroupFormat)

Wymagane. Wartość niezmienna. Format reklam w grupie reklam.
bidStrategy

object (BiddingStrategy)

Opcjonalnie: Strategia ustalania stawek używana przez grupę reklam. W strategii ustalania stawek można używać tylko pól youtubeAndPartnersBid i demandGenBid.
entityStatus

enum (EntityStatus)

Wymagane. Określa, czy grupa reklam może wydawać budżet i ustalać stawki za zasoby reklamowe.

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

object (TargetingExpansionConfig)

Opcjonalnie: Ustawienia kierowania zoptymalizowanego w grupie reklam.
productFeedData

object (ProductFeedData)

Opcjonalnie: Ustawienia pliku danych o produktach w tej grupie reklam.
adGroupInventoryControl

object (AdGroupInventoryControl)

Opcjonalnie: Wymagane w przypadku grup reklam generujących popyt. Określa ustawienia zasobów reklamowych grupy reklam.
adSource

enum (AdSource)

Opcjonalnie: Źródło reklam w tej grupie reklam. To pole jest używane tylko wtedy, gdy reklamy są generowane automatycznie z danego źródła.
creativeAssignments[]

object (CreativeAssignment)

Opcjonalnie: Kreacje używane do generowania reklam w grupie reklam.

To pole można przypisać tylko wtedy, gdy adSource to AD_SOURCE_DV360_CREATIVE.

AdGroupFormat

Format grupy reklam.

Wartości w polu enum
AD_GROUP_FORMAT_UNSPECIFIED Wartość formatu nie jest określona lub jest nieznana w tej wersji.
AD_GROUP_FORMAT_IN_STREAM Reklamy In-Stream.
AD_GROUP_FORMAT_VIDEO_DISCOVERY Reklamy In-Feed.
AD_GROUP_FORMAT_BUMPER Bumpery reklamowe.
AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM Reklamy In-Stream niemożliwe do pominięcia.
AD_GROUP_FORMAT_AUDIO Reklamy audio In-Stream niemożliwe do pominięcia.
AD_GROUP_FORMAT_RESPONSIVE Reklamy elastyczne.
AD_GROUP_FORMAT_REACH Grupy reklam z opcją „Skuteczny zasięg”, w tym reklamy In-Stream i bumpery reklamowe.
AD_GROUP_FORMAT_MASTHEAD Reklama w banerze masthead wyświetlana w górnej części strony głównej YouTube.
AD_GROUP_FORMAT_DEMAND_GEN reklamy generujące popyt.

ProductFeedData

Szczegóły pliku danych o produktach.

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

enum (ProductMatchType)

Jak produkty są wybierane przez plik danych o produktach.
productMatchDimensions[]

object (ProductMatchDimension)

Lista wymiarów używanych do dopasowywania produktów.
isFeedDisabled

boolean

Określa, czy w pliku danych o produktach wyłączono wyświetlanie produktów.

ProductMatchType

Typy sposobów dopasowywania produktów.

Wartości w polu enum
PRODUCT_MATCH_TYPE_UNSPECIFIED Nie określono lub nieznany.
PRODUCT_MATCH_TYPE_ALL_PRODUCTS Wszystkie produkty są dopasowane.
PRODUCT_MATCH_TYPE_SPECIFIC_PRODUCTS Wybrano konkretne produkty.
PRODUCT_MATCH_TYPE_CUSTOM_LABEL Dopasuj produkty według ich etykiet własnych.

ProductMatchDimension

Wymiar używany do dopasowywania produktów.

Zapis 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.
}
Pola
Wymiar i wartość, na podstawie których ma zostać dopasowany produkt. Poniżej znajduje się lista pól, które wzajemnie się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
productOfferId

string

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

object (CustomLabel)

Etykieta własna, która ma pasować do wszystkich produktów z tą etykietą.
Koniec pól wykluczających się wzajemnie.

CustomLabel

Klucz i wartość etykiety własnej.

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 Nie określono lub nieznany.
CUSTOM_LABEL_KEY_0 Indeks klucza 0.
CUSTOM_LABEL_KEY_1 Indeks klucza 1.
CUSTOM_LABEL_KEY_2 Indeks klucza 2.
CUSTOM_LABEL_KEY_3 Indeks klucza 3.
CUSTOM_LABEL_KEY_4 Indeks klucza 4.

AdGroupInventoryControl

Ustawienie sterowania zasobami reklamowymi w grupie reklam.

Zapis 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.
}
Pola
Ustawienie sterowania zasobami reklamowymi w grupie reklam. Poniżej znajduje się lista pól, które wzajemnie się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
adGroupInventoryStrategy

enum (AdGroupInventoryStrategy)

Strategia dotycząca asortymentu.
selectedInventories

object (SelectedInventories)

Wybrane zasoby reklamowe.
Koniec pól wykluczających się wzajemnie.

AdGroupInventoryStrategy

Strategia asortymentowa grupy reklam.

Wartości w polu enum
AD_GROUP_INVENTORY_STRATEGY_UNSPECIFIED Nie określono lub nieznany.
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_AND_DISPLAY_NETWORK_INVENTORY Grupa reklam ma włączone wyświetlanie we wszystkich zasobach reklamowych w Google i sieci reklamowej.
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_INVENTORY Grupa reklam jest objęta wszystkimi zasobami reklamowymi Google.

SelectedInventories

Ustawienie sterowania zasobami reklamowymi w grupie reklam.

Zapis JSON 
{
  "allowYoutubeStream": boolean,
  "allowYoutubeShorts": boolean,
  "allowYoutubeFeed": boolean,
  "allowDiscover": boolean,
  "allowGmail": boolean,
  "allowGoogleDisplayNetwork": boolean
}
Pola
allowYoutubeStream

boolean

Określa, czy grupa reklam jest objęta zasobami reklamowymi In-Stream w YouTube.
allowYoutubeShorts

boolean

Określa, czy grupa reklam jest objęta zasobami reklamowymi YouTube Shorts.
allowYoutubeFeed

boolean

Czy grupa reklam jest objęta zasobami reklamowymi In-Feed w YouTube.
allowDiscover

boolean

Określa, czy grupa reklam jest objęta zasobami reklamowymi na kartach Discover.
allowGmail

boolean

Określa, czy grupa reklam jest uwzględniana w zasobach reklamowych Gmaila.
allowGoogleDisplayNetwork

boolean

Określa, czy grupa reklam ma włączone wyświetlanie w zasobach reklamowych w sieci reklamowej Google.

AdSource

Źródło reklam w tej grupie reklam.

Wartości w polu enum
AD_SOURCE_UNSPECIFIED Nie określono lub nieznany. Domyślnie jest to zwykłe źródło reklam.
AD_SOURCE_DV360_CREATIVE Pochodzi z kreacji DV360.

CreativeAssignment

Szczegóły kreacji przypisanej do grupy reklam.

Zapis JSON 
{
  "creativeId": string
}
Pola
creativeId

string (int64 format)

Wymagane. Identyfikator kreacji Display & Video 360 przypisanej do grupy reklam.

Metody

bulkEditAssignedTargetingOptions

 Edytuje zbiorczo opcje kierowania w wielu grupach reklam.

bulkListAssignedTargetingOptions

 Wyświetla listę opcji kierowania przypisanych do wielu grup reklam w ramach różnych typów kierowania.

create

 Tworzy nową grupę reklam.

delete

 Usuwa grupę reklam.

get

 Pobiera grupę reklam.

list

 Wyświetla listę grup reklam.

patch

 Aktualizuje istniejącą grupę reklam.