Method: googleAdsFields.search

Arama sorgusuyla eşleşen tüm alanları döndürür.

Verilen hataların listesi: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

İstek içeriği

İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:

JSON gösterimi
{
  "query": string,
  "pageToken": string,
  "pageSize": integer
}
Alanlar
query

string

Zorunlu. Sorgu dizesi.

pageToken

string

Alınacak sayfanın jetonu. Belirtilmezse, sonuçların ilk sayfası döndürülür. Sonraki sonuç sayfasını istemek için önceki yanıtta nextPageToken özelliğinden alınan değeri kullanın.

pageSize

integer

Tek bir sayfada alınacak öğe sayısı. Çok büyük bir sayfa istendiğinde sunucu, döndürülen kaynakların sayısını daha da sınırlandırmaya karar verebilir.

Yanıt gövdesi

GoogleAdsFieldService.SearchGoogleAdsFields için yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi
{
  "results": [
    {
      object (GoogleAdsField)
    }
  ],
  "nextPageToken": string,
  "totalResultsCount": string
}
Alanlar
results[]

object (GoogleAdsField)

Sorguyla eşleşen alanların listesi.

nextPageToken

string

Sonraki sonuç sayfasını almak için kullanılan sayfalandırma jetonu. Bu dizenin içeriğini bir sonraki isteğin pageToken özelliği olarak iletin. nextPageToken son sayfa için döndürülmez.

totalResultsCount

string (int64 format)

LIMIT yantümcesi yok sayıldığında sorguyla eşleşen toplam sonuç sayısı.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.