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

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

  1. Google API कंसोल पर जाएं और अपने एडमिन प्रोजेक्ट पर जाएं.
  2. पुष्टि करें कि एपीआई और सेवाएं में जाकर, आपके प्रोजेक्ट के लिए Ads Data Hub API चालू है.
    1. अगर ऐसा नहीं है, तो + एपीआई और सेवाएं चालू करें पर क्लिक करें और Ads Data Hub API को चालू करें.
  3. बाईं ओर मौजूद नेविगेशन मेन्यू में, आईएएम और एडमिन > सेवा खाते पर क्लिक करें.
    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 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 में क्वेरी के सैंपल देखें.
  • एपीआई के बारे में जानने और उसे अपने इस्तेमाल के उदाहरण के हिसाब से बनाने के लिए, सैंपल को बड़ा करें. इसके बाद, ये काम करें:
  • अगर आपको एपीआई के बारे में कोई सवाल पूछना है या सुझाव/राय देनी है या शिकायत करनी है, तो ADH की सहायता टीम से संपर्क करें.
पीछे जाएं
अपना खाता सेट अप करना
आगे बढ़ें
वेब यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करना