Method: customers.googleAds.searchStream

खोज स्ट्रीम क्वेरी से मेल खाने वाली सभी पंक्तियां दिखाता है.

इस्तेमाल की गई गड़बड़ियों की सूची: AuthenticationError AuthorizationError ChangeEventError ChangeStatusError ClickViewError HeaderError InternalError QueryError QuotaError RequestError

एचटीटीपी अनुरोध

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

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ के पैरामीटर

पैरामीटर
customerId

string

ज़रूरी है. जिस ग्राहक से क्वेरी की गई है उसका आईडी.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:

जेएसओएन के काेड में दिखाना 
{
  "query": string,
  "summaryRowSetting": enum (SummaryRowSetting)
}
फ़ील्ड
query

string

ज़रूरी है. क्वेरी स्ट्रिंग.
summaryRowSetting

enum (SummaryRowSetting)

इससे तय होता है कि खास जानकारी वाली लाइन दिखेगी या नहीं. डिफ़ॉल्ट रूप से, खास जानकारी वाली पंक्ति नहीं दिखती. अनुरोध किए जाने पर, क्वेरी के अन्य सभी नतीजे मिलने के बाद, खास जानकारी वाली लाइन अपने-आप जवाब के तौर पर भेज दी जाती है.

जवाब का मुख्य भाग

GoogleAdsService.SearchStream के लिए जवाब मैसेज.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

जेएसओएन के काेड में दिखाना 
{
  "results": [
    {
      object (GoogleAdsRow)
    }
  ],
  "fieldMask": string,
  "summaryRow": {
    object (GoogleAdsRow)
  },
  "requestId": string,
  "queryResourceConsumption": string
}
फ़ील्ड
results[]

object (GoogleAdsRow)

क्वेरी से मेल खाने वाली पंक्तियों की सूची.
fieldMask

string (FieldMask format)

फ़ील्डमास्क से पता चलता है कि उपयोगकर्ता ने किन फ़ील्ड के लिए अनुरोध किया था.

यह फ़ील्ड के पूरी तरह क्वालिफ़ाइड नामों की कॉमा-सेपरेटेड लिस्ट है. उदाहरण: "user.displayName,photo".
summaryRow

object (GoogleAdsRow)

खास जानकारी वाली ऐसी लाइन जिसमें नतीजों में मौजूद मेट्रिक की खास जानकारी होती है. मेट्रिक की खास जानकारी का मतलब है सभी नतीजों में मेट्रिक को एग्रीगेट करना. यहां एग्रीगेशन का मतलब योग, औसत, दर वगैरह हो सकता है.
requestId

string

अनुरोध का यूनीक आईडी, जिसका इस्तेमाल डीबग करने के लिए किया जाता है.
queryResourceConsumption

string (int64 format)

किसी क्वेरी को पूरा करने के लिए इस्तेमाल किए गए संसाधनों की संख्या. खास जानकारी वाली पंक्ति के लिए queryResourceConsumption और खास जानकारी वाली पंक्तियों में अलग-अलग जवाब दिखाए जाते हैं. खास जानकारी के अलावा किसी अन्य जवाब के लिए queryResourceConsumption, नतीजों के आखिरी बैच में दिखाया जाता है.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.