Method: customers.googleAds.searchStream

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

थ्रो की गई गड़बड़ियों की सूची: AuthenticationError AuthorizationError ChangeEventError ChangeStatusError ClickViewError HeaderError InternalError QueryError QuotaError RequestError

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

POST https://googleads.googleapis.com/v14/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
}
फ़ील्ड
results[]

object (GoogleAdsRow)

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

string (FieldMask format)

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

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

object (GoogleAdsRow)

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

string

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

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

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

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

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