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

इस गाइड में बताया गया है कि ऐसे ऐप्लिकेशन कैसे लिखें जो Ads Data Hub REST API का इस्तेमाल करके, Ads Data Hub के साथ इंटरैक्ट करते हैं. 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 API लाइब्रेरी पर जाएं.
   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 API, आपके Ads Data Hub ग्राहक खाते में मौजूद डेटा को ऐक्सेस कर सकता है और उसमें बदलाव कर सकता है. इसलिए, यह पुष्टि करना ज़रूरी है कि आप उपयोगकर्ता हैं और आपको अनुमति मिली हुई है. इसलिए, Ads Data Hub API के साथ इंटरैक्ट करने से पहले, आपको अनुमति देने वाले फ़्लो के बारे में जानकारी देनी होगी. ऑथराइज़ेशन फ़्लो, आपको एपीआई का इस्तेमाल करने के लिए ज़रूरी अनुमतियां देता है. OAuth 2.0 या किसी सेवा खाते का इस्तेमाल करके, अपने नंबर की पुष्टि की जा सकती है.

OAuth 2.0 सेवा खाता

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

1. Google API कंसोल पर जाएं और अपने एडमिन प्रोजेक्ट पर जाएं.
2. पुष्टि करें कि एपीआई और सेवाओं में, आपके प्रोजेक्ट के लिए Ads Data Hub API चालू है.
   1. अगर ऐसा नहीं है, तो + एपीआई और सेवाएं चालू करें पर क्लिक करें और Ads Data Hub API को चालू करें.
3. बाईं ओर मौजूद नेविगेशन मेन्यू में, IAM और एडमिन > सेवा खाते पर क्लिक करें.
   1. अगर आपने अभी तक सेवा खाता नहीं बनाया है, तो एक खाता बनाएं.
4. "कार्रवाइयां" में जाकर, तीन बिंदु वाले मेन्यू () पर क्लिक करें. इसके बाद, बटन मैनेज करें पर क्लिक करें.
   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 customer ID.
customer_name = input('Customer name (e.g. "customers/123"): ').strip()
queries = service.customers().analysisQueries().list(
    parent=customer_name).execute()
print(json.dumps(queries, sort_keys=True, indent=4))

अगले चरण

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