Search Ads 360 Reporting API का नया वर्शन अब उपलब्ध है. आने वाले समय में किए जाने वाले बदलावों और रिलीज़ के बारे में अप-टू-डेट रहने के लिए, searchads-api-announcements Google ग्रुप में शामिल हों.

इस पेज का अनुवाद Cloud Translation API से किया गया है.

ऑथराइज़ेशन और एचटीटीपी हेडर

Search Ads 360 Reporting API को कॉल करते समय, आपके पास OAuth 2.0 ऐप्लिकेशन क्रेडेंशियल होने चाहिए. अगर एपीआई कॉल इस तौर पर किए जा रहे हैं Search Ads 360 मैनेजर खाता है, तो आपको login-customer-id हेडर भी डालना होगा का इस्तेमाल किया जा सकता है. इस पेज पर, इन वैल्यू और दस्तावेज़ों को सेट करने का तरीका बताया गया है कई अतिरिक्त API-विशिष्ट एचटीटीपी हेडर जो तब भेजे और पाए जाते हैं जब REST इंटरफ़ेस का इस्तेमाल करके.

OAuth 2.0 क्रेडेंशियल

Search Ads 360 Reporting API, एपीआई की पहचान करने और उसे अनुमति देने के लिए, ऐप्लिकेशन क्रेडेंशियल का इस्तेमाल करता है अनुरोध. OAuth 2.0 क्लाइंट कॉन्फ़िगर किए जा सकते हैं. Search Ads 360 Reporting API के सभी कॉल की अनुमति, OAuth2 से दी जानी चाहिए. OAuth2 की मदद से, Search Ads 360 Reporting API के क्लाइंट ऐप्लिकेशन की मदद से, उपयोगकर्ता के Search Ads 360 खाते को ऐक्सेस किया जा सकता है. इसके लिए, उपयोगकर्ता के लॉगिन की जानकारी को मैनेज या सेव नहीं करना पड़ता.

अगर आपने इससे पहले Google API का इस्तेमाल नहीं किया है, तो oauth2l या OAuth 2.0 प्लेग्राउंड के साथ एक्सपेरिमेंट करें के लिए कोड लिखने से पहले, आवेदन के क्रेडेंशियल और Search Ads 360 Reporting API की पुष्टि करें है. आपके पास दी गई उपयोगकर्ता के क्रेडेंशियल जनरेट करने वाली स्क्रिप्ट को चलाकर, OAuth रीफ़्रेश टोकन जनरेट करने का भी विकल्प है.

नए ऐक्सेस टोकन जनरेट किए जा रहे हैं

आपको क्लाइंट आईडी, क्लाइंट सीक्रेट, और रीफ़्रेश टोकन मिल जाने के बाद, ये काम किए जा सकते हैं एपीआई कॉल में इस्तेमाल करने के लिए, नया ऐक्सेस टोकन जनरेट करें curl कमांड-लाइन टूल:

curl \
  --data "grant_type=refresh_token" \
  --data "client_id=CLIENT_ID" \
  --data "client_secret=CLIENT_SECRET" \
  --data "refresh_token=REFRESH_TOKEN" \
  https://www.googleapis.com/oauth2/v3/token

इसके बाद, आप यूआरएल में कर्ल अनुरोध से मिले ऐक्सेस टोकन का इस्तेमाल कर सकते हैं Authorization Search Ads 360 Reporting API के हर एपीआई कॉल का एचटीटीपी हेडर:

GET /v0/customers:listAccessibleCustomers HTTP/1.1
Host: searchads360.googleapis.com
Authorization: Bearer ACCESS_TOKEN

अनुरोध के हेडर

लॉगिन ग्राहक आईडी

मैनेजर खाते से क्लाइंट खाते में किए गए Search Ads 360 Reporting API कॉल के लिए (यानी कि मैनेजर के तौर पर लॉग इन करके, अपने किसी क्लाइंट खाते को एपीआई कॉल करने के लिए, आपको login-customer-id एचटीटीपी हेडर भी देना होगा. यह मान दिखाता है एपीआई कॉल करने वाले मैनेजर का Search Ads 360 ग्राहक आईडी.

इस हेडर को शामिल करना, Search Ads 360 यूज़र इंटरफ़ेस (यूआई) में कोई खाता चुनने के बराबर है साइन इन करने या उसके शीर्ष-दाएं कोने पर अपनी प्रोफ़ाइल चित्र पर क्लिक करने के बाद पेज. ग्राहक आईडी तय करते समय, सभी हाइफ़न (—) हटाना न भूलें, उदाहरण के लिए: 1234567890, 123-456-7890 नहीं.

GET /v0/customers:listAccessibleCustomers HTTP/1.1
Host: searchads360.googleapis.com
Authorization: Bearer ACCESS_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID

रिस्पॉन्स हेडर

एपीआई से एचटीटीपी रिस्पॉन्स में नीचे दिए गए हेडर दिखाए जाते हैं.

अनुरोध का आईडी

request-id एक स्ट्रिंग है, जो एपीआई अनुरोध की खास तौर पर पहचान करती है. टास्क कब शुरू होगा एपीआई कॉल, request-id जैसी खास तरह के एपीआई कॉल को डीबग करने या हल करने से जुड़ी समस्याओं को हल करना एक महत्वपूर्ण आइडेंटिफ़ायर है, जो Google डेवलपर से संपर्क करते समय आसानी से उपलब्ध हो सहायता.

request-id: 2a5Cj89VV7CNhya1DZjjrC