Method: googleAdsFields.search

Zwraca wszystkie pola pasujące do wyszukiwanego hasła.

Lista zgłoszonych błędów: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError.

Żądanie HTTP

POST https://googleads.googleapis.com/v16/googleAdsFields:search

Adres URL używa składni transkodowania gRPC.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "query": string,
  "pageToken": string,
  "pageSize": integer
}
Pola
query

string

To pole jest wymagane. Ciąg zapytania.

pageToken

string

Token strony do pobrania. Jeśli nie podasz żadnej wartości, wyświetlana będzie pierwsza strona wyników. Użyj wartości uzyskanej z funkcji nextPageToken w poprzedniej odpowiedzi, aby zażądać następnej strony wyników.

pageSize

integer

Liczba elementów do pobrania w ramach jednej strony. W przypadku żądania zbyt dużej strony serwer może zdecydować się na dalsze ograniczenie liczby zwracanych zasobów.

Treść odpowiedzi

Odpowiedź na pytanie: GoogleAdsFieldService.SearchGoogleAdsFields.

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

Zapis JSON
{
  "results": [
    {
      object (GoogleAdsField)
    }
  ],
  "nextPageToken": string,
  "totalResultsCount": string
}
Pola
results[]

object (GoogleAdsField)

Lista pól pasujących do zapytania.

nextPageToken

string

Token podziału na strony używany do pobierania następnej strony wyników. Przekaż zawartość tego ciągu jako atrybut pageToken w następnym żądaniu. dla ostatniej strony nie zwracany jest nextPageToken.

totalResultsCount

string (int64 format)

Łączna liczba wyników pasujących do zapytania z pominięciem klauzuli LIMIT.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w omówieniu protokołu OAuth 2.0.