Method: customers.googleAds.searchStream

Arama akışı sorgusuyla eşleşen tüm satırları döndürür.

Atılan hataların listesi: AuthenticationError AuthorizationError ChangeEventError ChangeStatusError ClickViewError HeaderError InternalError QueryError QuotaError RequestError

HTTP isteği

POST https://googleads.googleapis.com/v16/customers/{customerId}/googleAds:searchStream

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

Yol parametreleri

Parametreler
customerId

string

Zorunlu. Sorgulanan müşterinin kimliği.

İstek içeriği

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

JSON gösterimi 
{
  "query": string,
  "summaryRowSetting": enum (SummaryRowSetting)
}
Alanlar
query

string

Zorunlu. Sorgu dizesi.
summaryRowSetting

enum (SummaryRowSetting)

Bir özet satırının döndürülüp döndürülmeyeceğini belirler. Varsayılan olarak özet satırı döndürülmez. İstenirse diğer tüm sorgu sonuçları döndürüldükten sonra özet satırı tek başına yanıt olarak gönderilir.

Yanıt gövdesi

GoogleAdsService.SearchStream 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 (GoogleAdsRow)
    }
  ],
  "fieldMask": string,
  "summaryRow": {
    object (GoogleAdsRow)
  },
  "requestId": string,
  "queryResourceConsumption": string
}
Alanlar
results[]

object (GoogleAdsRow)

Sorguyla eşleşen satırların listesi.
fieldMask

string (FieldMask format)

Kullanıcının istediği alanları temsil eden FieldMask.

Bu, tam nitelikli alan adlarının virgülle ayrılmış bir listesidir. Örnek: "user.displayName,photo".
summaryRow

object (GoogleAdsRow)

Sonuçlardaki metriklerin özetini içeren özet satırı. Metriklerin özeti, tüm sonuçlardaki metriklerin toplamı anlamına gelir. Burada toplama, toplam, ortalama, oran vb. olabilir.
requestId

string

Hata ayıklama amacıyla kullanılan isteğin benzersiz kimliği.
queryResourceConsumption

string (int64 format)

Sorguyu sunmak için tüketilen kaynakların miktarı. Özet satırı ve Özet olmayan yanıtlar için ayrı ayrı döndürülür. Özet olmayan yanıtlar için queryResourceConsumption son toplu sonuçlarda döndürülür.

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.