REST Resource: advertisers.adGroups

Zasób: AdGroup

Jedna 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)
  }
}
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. 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. 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 wykorzystywać 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 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 kontrolę nad zasobami reklamowymi w grupie reklam.

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 skutecznego zasięgu, w tym reklamy In-Stream i bumpery reklamowe.
AD_GROUP_FORMAT_MASTHEAD Reklama w banerze masthead wyświetlana w górnym boksie reklamowym na stronie 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

Informuje, czy plik danych o produktach został wyłączony z 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 Wybrano konkretne produkty.
PRODUCT_MATCH_TYPE_CUSTOM_LABEL Dopasowywanie produktów według 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 zbiorcze dimension. Wymiar i wartość, do których ma nastąpić dopasowanie produktu. dimension może mieć tylko jedną z tych wartości:
productOfferId

string

Identyfikator oferty produktu, który ma być 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ą.

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 Nieokreślony lub nieznany.
CUSTOM_LABEL_KEY_0 Indeks klucza 0.
CUSTOM_LABEL_KEY_1 Kluczowy indeks 1.
CUSTOM_LABEL_KEY_2 Kluczowy indeks 2.
CUSTOM_LABEL_KEY_3 Kluczowy indeks 3.
CUSTOM_LABEL_KEY_4 Kluczowy indeks 4.

AdGroupInventoryControl

Kontrola zasobów reklamowych w grupie reklam.

Zapis JSON 
{

  // Union field inventory_controls can be only one of the following:
  "adGroupInventoryStrategy": enum (AdGroupInventoryStrategy),
  "selectedInventories": {
    object (SelectedInventories)
  }
  // End of list of possible types for union field inventory_controls.
}
Pola
Pole zbiorcze inventory_controls. Kontrola zasobów reklamowych w grupie reklam. inventory_controls może mieć tylko jedną z tych wartości:
adGroupInventoryStrategy

enum (AdGroupInventoryStrategy)

Strategia dotycząca zasobów reklamowych.
selectedInventories

object (SelectedInventories)

Wybrane zasoby reklamowe.

AdGroupInventoryStrategy

Strategia dotycząca zasobów reklamowych w grupie reklam.

Wartości w polu enum
AD_GROUP_INVENTORY_STRATEGY_UNSPECIFIED Nieokreślony 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 włączona we wszystkich zasobach reklamowych 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 włączona w zasobach reklamowych In-Stream w YouTube.
allowYoutubeShorts

boolean

Informacja, czy grupa reklam jest włączona w zasobach reklamowych YouTube Shorts.
allowYoutubeFeed

boolean

Określa, czy grupa reklam jest włączona w zasobach reklamowych In-Feed w YouTube.
allowDiscover

boolean

Określa, czy grupa reklam jest włączona w zasobach reklamowych Discover.
allowGmail

boolean

Określa, czy grupa reklam jest włączona w zasobach reklamowych Gmaila.
allowGoogleDisplayNetwork

boolean

Czy grupa reklam ma włączone zasoby reklamowe sieci reklamowej Google.

Metody

bulkEditAssignedTargetingOptions

 Edycja zbiorcza opcji kierowania w wielu grupach reklam.

bulkListAssignedTargetingOptions

 Wyświetla listę opcji kierowania przypisanych do wielu grup reklam w różnych typach 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.