REST Resource: advertisers.adGroups

Zasób: grupa reklam

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)
  }
}
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. Przypisana 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 o maksymalnym rozmiarze 255 bajtów.
adGroupFormat

enum (AdGroupFormat)

Format reklam w grupie.
bidStrategy

object (BiddingStrategy)

Strategia ustalania stawek używana przez grupę reklam. W strategii ustalania stawek można używać tylko pola youtubeAndPartnersBid.
entityStatus

enum (EntityStatus)

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

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

object (TargetingExpansionConfig)

Ustawienia kierowania zoptymalizowanego w grupie reklam.
productFeedData

object (ProductFeedData)

Ustawienia pliku danych o produktach w tej grupie reklam.

AdGroupFormat

Format grupy reklam.

Wartości w polu enum
AD_GROUP_FORMAT_UNSPECIFIED Wartość formatu nie została 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 ze strategią „Skuteczny zasięg”, w tym reklamy In-Stream i bumpery reklamowe.
AD_GROUP_FORMAT_MASTHEAD Reklama w banerze masthead, która wyświetla się w górnym boksie 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 wybierania produktów w pliku danych o produktach.
productMatchDimensions[]

object (ProductMatchDimension)

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

boolean

Czy w pliku danych o produktach wyłączono wyświetlanie produktów.

ProductMatchType

Rodzaje 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 służący 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 sumy dimension. Wymiar i wartość, według których ma być dopasowywany produkt. dimension może mieć tylko jedną z tych wartości:
productOfferId

string

Identyfikator oferty produktu, która pasuje do produktu o tym samym identyfikatorze oferty.
customLabel

object (CustomLabel)

Etykieta własna pasująca 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 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.

Metody

bulkListAdGroupAssignedTargetingOptions

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

get

 Pobiera grupę reklam.

list

 Wyświetla listę grup reklam.