Ads Data Hub API का इस्तेमाल शुरू करना

इस गाइड में, Ads Data Hub के साथ इंटरैक्ट करने के लिए, Ads Data Hub REST API का इस्तेमाल करने वाले ऐप्लिकेशन लिखना शुरू करने का तरीका बताया गया है. Ads Data Hub REST API की मदद से, अपने Google खाते से जुड़े Ads Data Hub ग्राहकों को देखा जा सकता है, क्वेरी बनाई जा सकती हैं, और क्वेरी चलाई जा सकती हैं.

सेटअप

Ads Data Hub API का इस्तेमाल करने से पहले, आपको ये काम पूरे करने होंगे:

  1. पक्का करें कि जिस उपयोगकर्ता ने एपीआई की सुविधा चालू की है उसे अनुमति मिली हो Google Cloud प्रोजेक्ट में serviceusage.services.enable अनुमति. किसी उपयोगकर्ता ऐसे लोगों या संगठनों की भी सूची में शामिल होना चाहिए जिन्हें serviceusage.services.enable अनुमति मिली है उसे ऐक्सेस करें.
  2. उस Google Cloud प्रोजेक्ट में Ads Data Hub API चालू करें जिसमें क्लाइंट क्रेडेंशियल या सेवा खाता बनाया गया था. कंसोल का इस्तेमाल करके किसी प्रोजेक्ट के लिए Ads Data Hub API चालू करने के लिए:
    1. Cloud Console एपीआई लाइब्रेरी पर जाएं.
    2. प्रोजेक्ट की सूची में से वह प्रोजेक्ट चुनें जिसका इस्तेमाल करना है.
    3. "Ads Data Hub API" खोजें.
    4. एपीआई पेज पर, चालू करें पर क्लिक करें.
  3. अनुमतियां मैनेज करें:
    1. क्रेडेंशियल बनाने के लिए इस्तेमाल किया गया ईमेल पता या सेवा खाता, यह ज़रूरी है की मदद से Ads Data Hub में जोड़ी जा सकती हैं ज़रूरी अनुमतियां होनी चाहिए. सेवा खाते के लिए, यह सेवा खाते का ईमेल पता है. इसके लिए OAuth, यह उपयोगकर्ता का ईमेल पता है. इससे पक्का होता है कि सेवा में खाते या असली उपयोगकर्ता के खाते के पास क्वेरी चलाने की अनुमति है Ads Data Hub.
  4. Google API क्लाइंट लाइब्रेरी इंस्टॉल करें (इसका सुझाव दिया जाता है):
    1. Google API क्लाइंट लाइब्रेरी कई लोकप्रिय जगहों में उपलब्ध है भाषाओं के साथ काम कर सकते हैं. साथ ही, आपको कई Google API के साथ काम करने की सुविधा भी मिलती है. हालांकि, ऐसा नहीं होता है तो क्लाइंट लाइब्रेरी आपके पास मौजूद कोड की मात्रा को कम कर देती है लिखने में मदद करता है. साथ ही, पुष्टि करने की प्रोसेस को सेट अप करना आसान बनाता है.
क्लाइंट लाइब्रेरी Ads Data Hub के सैंपल
Java के लिए Google API क्लाइंट लाइब्रेरी Java
Python के लिए Google API क्लाइंट लाइब्रेरी

पुष्टि करें और अनुमति दें

Ads Data Hub एपीआई आपके Ads Data Hub ग्राहक के डेटा को ऐक्सेस कर सकता है और उसमें बदलाव कर सकता है खाता है, इसलिए यह पुष्टि करनी होगी कि आप अधिकृत उपयोगकर्ता हैं. इस वजह से, Ads Data Hub API के साथ इंटरैक्ट करना शुरू करने से पहले, आपको अनुमति देने के फ़्लो के ज़रिए, ऑथराइज़ेशन फ़्लो से आपको एपीआई का इस्तेमाल करने के लिए ज़रूरी अनुमतियां. इसका इस्तेमाल करके पुष्टि की जा सकती है OAuth 2.0 या सेवा खाता होना चाहिए.

सेवा खाते का सेटअप

  1. Google API कंसोल पर जाएं और अपने एडमिन प्रोजेक्ट पर जाएं.
  2. पुष्टि करें कि एपीआई और सेवाएं.
    1. अगर ऐसा नहीं है, तो + एपीआई और सेवाएं चालू करें पर क्लिक करें और विज्ञापन चालू करें Data Hub एपीआई.
  3. बाएं नेविगेशन मेन्यू में, IAM और एडमिन > सेवा खाते.
    1. अगर आपने अभी तक सेवा खाता नहीं बनाया है, तो एक बनाएं.
  4. इसके नीचे दिए गए 3-बिंदु वाले मेन्यू () पर क्लिक करें "कार्रवाइयां" चुनें. इसके बाद, कुंजी मैनेज करें पर क्लिक करें.
    1. कुंजी जोड़ें पर क्लिक करें > नई कुंजी बनाएं
    2. पक्का करने के बाद कि "JSON" चुना गया है, तो बनाएं पर क्लिक करें.
  5. अपने Ads Data Hub में उपयोगकर्ता के तौर पर सेवा खाते का ईमेल पता जोड़ें जोड़ें.

सैंपल के तौर पर अनुरोध भेजना

#!/usr/bin/env python3

"""This sample shows how to retrieve all accounts associated with the user.
"""
import json
from google.oauth2.service_account import Credentials
from googleapiclient.discovery import build

SCOPES = ['https://www.googleapis.com/auth/adsdatahub']
DISCOVERY_URL = 'https://adsdatahub.googleapis.com/$discovery/rest?version=v1'
creds = Credentials.from_service_account_file(
    'service-account.json').with_scopes(SCOPES)
developer_key = 'YOUR_DEVELOPER_KEY'  # Replace with your developer key.
service = build('AdsDataHub', 'v1', credentials=creds,
                developerKey=developer_key, discoveryServiceUrl=DISCOVERY_URL)

# Replace with your ADH account ID.
adh_account_id = input('ADH account ID (e.g. "customers/123456789"): ').strip()
queries = service.customers().analysisQueries().list(
    parent=adh_account_id).execute()
print(json.dumps(queries, sort_keys=True, indent=4))

अगले चरण

  • Ads Data Hub REST API का इस्तेमाल करके बनाई और चलाई जा सकने वाली क्वेरी के उदाहरणों के लिए, Ads Data Hub में सैंपल क्वेरी देखें.
  • एपीआई के बारे में जानने और उसे अपने इस्तेमाल के हिसाब से बनाने के लिए, सैंपल देखें. इसके बाद, ये तरीके आज़माएं:
    • पोल क्वेरी की कार्रवाई की स्थिति.
    • क्वेरी के पूरे हो चुके नतीजे पाने के लिए, BigQuery क्लाइंट लाइब्रेरी का इस्तेमाल करें.
  • अगर एपीआई के बारे में आपका कोई सवाल है या आपको सुझाव देना है, तो ADH की सहायता टीम से संपर्क करें.
पीछे जाएं
अपना खाता सेट अप करना
आगे बढ़ें
वेब यूआई का इस्तेमाल करें