বিজ্ঞাপন ডেটা হাব API দিয়ে শুরু করুন

এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে বিজ্ঞাপন ডেটা হাবের সাথে ইন্টারঅ্যাক্ট করতে বিজ্ঞাপন ডেটা হাব REST API ব্যবহার করে এমন অ্যাপ্লিকেশন লেখা শুরু করবেন। বিজ্ঞাপন ডেটা হাব REST API আপনাকে আপনার Google অ্যাকাউন্টের সাথে যুক্ত বিজ্ঞাপন ডেটা হাব গ্রাহকদের দেখতে, প্রশ্ন তৈরি করতে এবং কোয়েরি চালানোর অনুমতি দেয়।

সেটআপ

বিজ্ঞাপন ডেটা হাব API ব্যবহার করার আগে আপনাকে কয়েকটি ধাপ সম্পূর্ণ করতে হবে:

  1. নিশ্চিত করুন যে API সক্রিয় করা ব্যবহারকারীকে Google ক্লাউড প্রকল্পে serviceusage.services.enable অনুমতি দেওয়া হয়েছে৷ serviceusage.services.enable অনুমতি সহ ব্যবহারকারীকেও API অ্যাক্সেস করার অনুমতি দিতে হবে।
  2. Google ক্লাউড প্রজেক্টে বিজ্ঞাপন ডেটা হাব API সক্ষম করুন যেখানে ক্লায়েন্ট শংসাপত্র বা পরিষেবা অ্যাকাউন্ট তৈরি করা হয়েছিল। কনসোল ব্যবহার করে একটি প্রকল্পের জন্য বিজ্ঞাপন ডেটা হাব API সক্ষম করতে:
    1. ক্লাউড কনসোল এপিআই লাইব্রেরিতে যান।
    2. প্রকল্পের তালিকা থেকে আপনি যে প্রকল্পটি ব্যবহার করতে চান তা নির্বাচন করুন।
    3. "Ads Data Hub API" অনুসন্ধান করুন।
    4. API পৃষ্ঠায়, ENABLE এ ক্লিক করুন।
  3. অনুমতি পরিচালনা করুন:
    1. শংসাপত্র তৈরি করতে ব্যবহৃত ইমেল ঠিকানা বা পরিষেবা অ্যাকাউন্ট যথাযথ অনুমতি সহ বিজ্ঞাপন ডেটা হাবে যোগ করতে হবে। একটি পরিষেবা অ্যাকাউন্টের জন্য এটি পরিষেবা অ্যাকাউন্টের ইমেল ঠিকানা। OAuth এর জন্য, এটি ব্যবহারকারীর ইমেল ঠিকানা। এটি নিশ্চিত করে যে পরিষেবা অ্যাকাউন্ট বা শেষ-ব্যবহারকারীর অ্যাকাউন্টে বিজ্ঞাপন ডেটা হাবে প্রশ্নগুলি চালানোর অনুমতি রয়েছে।
  4. (প্রস্তাবিত) একটি Google API ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন:
    1. Google API ক্লায়েন্ট লাইব্রেরিগুলি বেশ কয়েকটি জনপ্রিয় ভাষায় উপলব্ধ, এবং আপনাকে অনেক Google API-এর সাথে কাজ করার অনুমতি দেয়। যদিও এটির প্রয়োজন হয় না, ক্লায়েন্ট লাইব্রেরিগুলি আপনাকে লিখতে হবে এমন কোডের পরিমাণ হ্রাস করে এবং প্রমাণীকরণকে সেট আপ করার জন্য সহজ করে তোলে।
ক্লায়েন্ট লাইব্রেরি বিজ্ঞাপন ডেটা হাবের নমুনা
জাভার জন্য Google API ক্লায়েন্ট লাইব্রেরি জাভা
পাইথনের জন্য Google API ক্লায়েন্ট লাইব্রেরি

প্রমাণীকরণ এবং অনুমোদন

Ads Data Hub API আপনার Ads Data Hub গ্রাহক অ্যাকাউন্টে ডেটা অ্যাক্সেস করতে এবং পরিবর্তন করতে পারে, তাই এটি যাচাই করতে হবে যে আপনি একজন অনুমোদিত ব্যবহারকারী। এই কারণে, আপনি বিজ্ঞাপন ডেটা হাব API-এর সাথে ইন্টারঅ্যাক্ট শুরু করার আগে, আপনাকে একটি অনুমোদনের প্রবাহের মধ্য দিয়ে যেতে হবে। একটি অনুমোদন প্রবাহ আপনাকে API এর সাথে ইন্টারঅ্যাক্ট করার জন্য প্রয়োজনীয় অনুমতি প্রদান করে। আপনি OAuth 2.0 বা একটি পরিষেবা অ্যাকাউন্ট ব্যবহার করে প্রমাণীকরণ করতে পারেন।

পরিষেবা অ্যাকাউন্ট সেটআপ

  1. Google API কনসোলে যান এবং আপনার অ্যাডমিন প্রকল্পে নেভিগেট করুন।
  2. এপিআই এবং পরিষেবার অধীনে আপনার প্রকল্পের জন্য বিজ্ঞাপন ডেটা হাব API সক্ষম করা আছে কিনা যাচাই করুন।
    1. যদি এটি না হয়, তাহলে + API এবং পরিষেবাগুলি সক্ষম করুন এবং বিজ্ঞাপন ডেটা হাব API সক্ষম করুন ক্লিক করুন৷
  3. বাম নেভিগেশন মেনুতে, IAM & Admin > Service Accounts-এ ক্লিক করুন।
    1. আপনি যদি এখনও একটি পরিষেবা অ্যাকাউন্ট তৈরি না করে থাকেন তবে একটি তৈরি করুন ৷
  4. 3-ডট মেনুতে ক্লিক করুন ( ) "Actions" এর অধীনে, তারপর ম্যানেজ কী ক্লিক করুন।
    1. কী যোগ করুন > নতুন কী তৈরি করুন ক্লিক করুন
    2. "JSON" নির্বাচন করা হয়েছে তা নিশ্চিত করার পরে, তৈরি করুন ক্লিক করুন।
  5. আপনার বিজ্ঞাপন ডেটা হাব অ্যাকাউন্টে ব্যবহারকারী হিসাবে পরিষেবা অ্যাকাউন্টের ইমেল ঠিকানা যোগ করুন।

একটি নমুনা অনুরোধ পাঠান

#!/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))

পরবর্তী পদক্ষেপ

পূর্ববর্তী
আপনার অ্যাকাউন্ট সেট আপ করুন
পরবর্তী
ওয়েব UI ব্যবহার করুন