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/v14/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 tych danych, zwracana jest pierwsza strona wyników. Użyj wartości uzyskanej z funkcji nextPageToken w poprzedniej odpowiedzi, aby zażądać następnej strony z wynikami.

pageSize

integer

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

Treść odpowiedzi

Wiadomość z odpowiedzią na temat: 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. nextPageToken nie jest zwracany w przypadku ostatniej strony.

totalResultsCount

string (int64 format)

Łączna liczba wyników pasujących do zapytania i zignorowana na klauzulę LIMIT.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

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