Method: customers.describeValidFrequencyLimitingEventMatchers

Zawiera prawidłowe dopasowania dopasowań zdarzeń i ich metadane na potrzeby list odbiorców z ograniczeniem liczby wyświetleń. Każdy system dopasowywania zdarzeń zawiera metadane, które obejmują np. własność AdsDataLink.Entity i nazwę odpowiedniego kampanii lub elementu zamówienia.

Żądanie HTTP

GET https://adsdatahub.googleapis.com/v1/{customer=customers/*}:describeValidFrequencyLimitingEventMatchers

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customer

string

Nazwa zasobu klienta, np. 'customers/123'.

Parametry zapytania

Parametry
adsDataCustomerId

string (int64 format)

Identyfikator klienta Google Ads, np. 456.
pageSize

integer

Maksymalna liczba elementów do zwrócenia. Jeśli wartość to 0, serwer określa liczbę połączonych klientów, których dane zostaną zwrócone.
pageToken

string

Token strony, zwrócony przez poprzednie wywołanie, używany do żądania następnej strony wyników (jeśli istnieje).
filter

string

Ogranicz zwracanie dopasowań zdarzeń. Akceptuje filtry we wszystkich polach podrzędnych zdarzeń eventMatcher, eventMatcherMetadata.entity i eventEventerMetadata.parent_event_matcher. Przykładowe filtry: eventMatcher.value = 1234 eventMatcher.match_type = DV360_LINE_ITEM_ID OR eventMatcher.match_type = DV360_INSERTION_ORDER_ID eventMatcherMetadata.display_name = "Campaign4466" eventMatcherMetadata.entity.entity.id.display.match.name [ton].{/1}

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

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

Odpowiedź na żądanie DescriptionValidCzęstotliwośćLimitingEventMatchersRequest.

Zapis JSON 
{
  "eventMatcherInfos": [
    {
      object (EventMatcherInfo)
    }
  ],
  "nextPageToken": string
}
Pola
eventMatcherInfos[]

object (EventMatcherInfo)

Lista jednostek, z których każda zawiera dopasowanie zdarzenia i jego metadane
nextPageToken

string

Token, którego można użyć do żądania następnej strony wyników. Jeśli nie ma żadnych dodatkowych wyników, to pole jest puste.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/adsdatahub

Informacje o zdarzeniu

Dopasowanie zdarzenia wraz z jego metadanymi.

Zapis JSON 
{
  "eventMatcher": {
    object (EventMatcher)
  },
  "eventMatcherMetadata": {
    object (EventMatcherMetadata)
  }
}
Pola
eventMatcher

object (EventMatcher)

Dopasowanie zdarzenia zawierające typ ograniczenia i prawidłowy identyfikator ograniczenia.
eventMatcherMetadata

object (EventMatcherMetadata)

Metadane tagu dopasowania zdarzenia.

Metadane zdarzenia

Metadane tagu dopasowania zdarzenia.

Zapis JSON 
{
  "entity": {
    object (Entity)
  },
  "displayName": string,
  "parentEventMatcher": {
    object (EventMatcher)
  }
}
Pola
entity

object (Entity)

Połączony element z AdsDataLink.
displayName

string

Nazwa bazowego źródła danych dla ograniczenia. Może to być nazwa kampanii, nazwa elementu zamówienia itp.
parentEventMatcher

object (EventMatcher)

Powiązany element nadrzędnych EventMatcher (jeśli istnieje). Jeśli Element EventMatcher jest elementem zamówienia DV360, to pole będzie odwoływać się do obiektu EventMatcher dla odpowiedniego zamówienia reklamowego DV360, do którego należy element zamówienia.