Method: advertisers.lineItems.bulkListAssignedTargetingOptions

Wyświetla listę opcji kierowania przypisanych dla wielu elementów zamówienia różnych typów kierowania.

Żądanie HTTP

GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems:bulkListAssignedTargetingOptions

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
advertiserId

string (int64 format)

To pole jest wymagane. Identyfikator reklamodawcy, do którego należą elementy zamówienia.

Parametry zapytania

Parametry
lineItemIds[]

string (int64 format)

To pole jest wymagane. Identyfikatory elementów zamówienia, dla których mają być wyświetlone przypisane opcje kierowania.
pageSize

integer

Żądany rozmiar strony. Rozmiar musi być liczbą całkowitą z zakresu od 1 do 5000. Jeśli wartość nie została podana, przyjmuje się wartość domyślną 5000. Zwraca kod błędu INVALID_ARGUMENT, jeśli określono nieprawidłową wartość.
pageToken

string

Token, który umożliwia klientowi pobranie następnej strony wyników. Zwykle jest to wartość nextPageToken zwrócona z poprzedniego wywołania metody lineItems.bulkListAssignedTargetingOptions. Jeśli nie podasz tych danych, zwracana jest pierwsza strona wyników.
orderBy

string

Pole służące do sortowania listy. Dopuszczalne wartości:

  • lineItemId (domyślnie)
  • assignedTargetingOption.targetingType

Domyślna kolejność sortowania jest rosnąca. Aby określić kolejność malejącą w przypadku pola, do jego nazwy musisz dodać sufiks „desc”. Przykład: targetingType desc.
filter

string

Umożliwia filtrowanie według przypisanych pól opcji kierowania.

Obsługiwana składnia:

  • Wyrażenia filtra składają się z co najmniej 1 ograniczenia.
  • Ograniczenia mogą być łączone w tym samym polu za pomocą operatora logicznego OR.
  • Ograniczenie ma postać {field} {operator} {value}.
  • Wszystkie pola muszą używać operatora EQUALS (=).

Obsługiwane pola:

  • targetingType
  • inheritance

Przykłady:

  • AssignedTargetingOption zasobu typu kierowania TARGETING_TYPE_PROXIMITY_LOCATION_LIST lub TARGETING_TYPE_CHANNEL: targetingType="TARGETING_TYPE_PROXIMITY_LOCATION_LIST" OR targetingType="TARGETING_TYPE_CHANNEL"
  • AssignedTargetingOption zasobu ze stanem dziedziczenia NOT_INHERITED lub INHERITED_FROM_PARTNER: inheritance="NOT_INHERITED" OR inheritance="INHERITED_FROM_PARTNER"

To pole nie może zawierać więcej niż 500 znaków.

Więcej informacji znajdziesz w naszym przewodniku po żądaniach filtra LIST.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "lineItemAssignedTargetingOptions": [
    {
      object (LineItemAssignedTargetingOption)
    }
  ],
  "nextPageToken": string
}
Pola
lineItemAssignedTargetingOptions[]

object (LineItemAssignedTargetingOption)

Lista obiektów kodu, z których każdy ma przypisaną opcję kierowania, oraz element zamówienia, do którego jest przypisana.

Tej listy nie będzie, jeśli będzie pusta.
nextPageToken

string

Token określający następną stronę wyników. Powinna ona być określona jako pageToken w kolejnym wywołaniu funkcji lineItems.bulkListAssignedTargetingOptions, która umożliwia pobranie następnej strony wyników. Jeśli nie będzie już żadnych lineItemAssignedTargetingOptions do zwrócenia, token będzie niedostępny.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/display-video

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

LineItemAssignedTargetingOption

Obiekt opakowania powiązany z zasobem assignedTargetingOption i elementem zamówienia, do którego jest przypisany.

Zapis JSON 
{
  "lineItemId": string,
  "assignedTargetingOption": {
    object (AssignedTargetingOption)
  }
}
Pola
lineItemId

string (int64 format)

Identyfikator elementu zamówienia, do którego jest przypisana przypisana opcja kierowania.
assignedTargetingOption

object (AssignedTargetingOption)

Przypisany zasób opcji kierowania.