यह फ़ंक्शन सर्च स्ट्रीम क्वेरी से मेल खाने वाली सभी लाइनों को दिखाता है.
थ्रो की गई गड़बड़ियों की सूची: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError
एचटीटीपी अनुरोध
POST https://searchads360.googleapis.com/v0/customers/{customerId}/searchAds360:searchStream
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ पैरामीटर
पैरामीटर | |
---|---|
customerId |
ज़रूरी है. उस ग्राहक का आईडी जिसके बारे में क्वेरी की गई है. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, यहां दिए गए स्ट्रक्चर का डेटा शामिल होता है:
JSON के काेड में दिखाना |
---|
{
"query": string,
"batchSize": integer,
"summaryRowSetting": enum ( |
फ़ील्ड | |
---|---|
query |
ज़रूरी है. क्वेरी स्ट्रिंग. |
batchSize |
हर स्ट्रीम रिस्पॉन्स बैच में दिखाई जाने वाली पंक्तियों की संख्या. बहुत बड़े बैच का अनुरोध किए जाने पर, सर्वर दिखाई जाने वाली पंक्तियों की संख्या को और सीमित कर सकता है. |
summaryRowSetting |
तय करता है कि खास जानकारी वाली पंक्ति दिखाई जाएगी या नहीं. डिफ़ॉल्ट रूप से, खास जानकारी वाली पंक्ति नहीं दिखती. अनुरोध किए जाने पर, सभी क्वेरी के नतीजे दिखाने के बाद, खास जानकारी वाली पंक्ति अपने-आप जवाब में भेज दी जाएगी. |
जवाब का मुख्य भाग
SearchAds360Service.SearchStream
के लिए जवाब देने वाला मैसेज.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
JSON के काेड में दिखाना |
---|
{ "results": [ { object ( |
फ़ील्ड | |
---|---|
results[] |
क्वेरी से मेल खाने वाली पंक्तियों की सूची. |
fieldMask |
फ़ील्डमास्क से पता चलता है कि उपयोगकर्ता ने किन फ़ील्ड के लिए अनुरोध किया था. यह फ़ील्ड के पूरी तरह क्वालिफ़ाइड नाम की सूची है, जिसे कॉमा लगाकर अलग किया गया है. उदाहरण: |
summaryRow |
खास जानकारी वाली लाइन, जिसमें नतीजों में मेट्रिक की खास जानकारी शामिल है. मेट्रिक की खास जानकारी का मतलब है कि सभी नतीजों में मेट्रिक को इकट्ठा किया जाता है. यहां कुल नतीजे, औसत, दर वगैरह के हिसाब से मेट्रिक की जानकारी इकट्ठा की जा सकती है. |
customColumnHeaders[] |
नतीजों में मौजूद कस्टम कॉलम के हेडर. |
conversionCustomMetricHeaders[] |
नतीजों में कन्वर्ज़न कस्टम मेट्रिक के हेडर. |
conversionCustomDimensionHeaders[] |
नतीजों में कन्वर्ज़न कस्टम डाइमेंशन के हेडर. |
rawEventConversionMetricHeaders[] |
नतीजों में, रॉ इवेंट कन्वर्ज़न मेट्रिक के हेडर. |
rawEventConversionDimensionHeaders[] |
नतीजों में, रॉ इवेंट कन्वर्ज़न डाइमेंशन के हेडर. |
requestId |
अनुरोध का यूनीक आईडी, जिसका इस्तेमाल डीबग करने के लिए किया जाता है. |
अनुमति के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/doubleclicksearch