অ্যাড ম্যানেজার API-এর সাথে ইন্টারঅ্যাক্ট করার জন্য Google একটি পাইথন ক্লায়েন্ট লাইব্রেরি প্রদান করে। আমরা PyPI এর সাথে ক্লায়েন্ট লাইব্রেরি ব্যবহার করার পরামর্শ দিই।
শুরু করতে, আপনার পছন্দের IDE-তে একটি নতুন প্রকল্প তৈরি করুন বা বিদ্যমান প্রকল্পে নির্ভরতা যোগ করুন। Google google-ads-admanager
হিসাবে PyPI-তে ক্লায়েন্ট লাইব্রেরি আর্টিফ্যাক্ট প্রকাশ করে।
pip install google-ads-admanager
শংসাপত্র কনফিগার করুন
Python ক্লায়েন্ট লাইব্রেরি প্রমাণীকরণের জন্য OAuth2 এবং অ্যাপ্লিকেশন ডিফল্ট শংসাপত্র (ADC) ব্যবহার করে।
ADC নিম্নলিখিত অবস্থানে ক্রেডেনশিয়াল অনুসন্ধান করে:
-
GOOGLE_APPLICATION_CREDENTIALS
পরিবেশ পরিবর্তনশীল। - Google Cloud CLI (gcloud CLI) এর মাধ্যমে ব্যবহারকারীর শংসাপত্র সেট আপ করা হয়েছে।
- Google ক্লাউডে চলাকালীন, Google ক্লাউড সংস্থানের সাথে সংযুক্ত পরিষেবা অ্যাকাউন্ট।
আপনার ADC শংসাপত্র তৈরি এবং কনফিগার করার জন্য, প্রমাণীকরণ দেখুন।
আপনার প্রথম অনুরোধ করুন
প্রতিটি পরিষেবাতে প্রতিটি REST পদ্ধতির জন্য সিঙ্ক্রোনাস এবং অ্যাসিঙ্ক্রোনাস উভয় পদ্ধতি সহ একটি ServiceClient
অবজেক্ট রয়েছে। নিম্নলিখিত উদাহরণটি একটি Network
সিঙ্ক্রোনাসভাবে পড়ে।
from google.ads import admanager_v1
def sample_get_network():
# Create a client
client = admanager_v1.NetworkServiceClient()
# Initialize request argument(s)
request = admanager_v1.GetNetworkRequest(
name="networks/[NETWORK_CODE]",
)
# Make the request
response = client.get_network(request=request)
# Handle the response
print(response)
অন্যান্য পদ্ধতি এবং সংস্থানগুলির উদাহরণের জন্য, GitHub সংগ্রহস্থল googleapis/google-cloud-python
দেখুন।
লগ HTTP অনুরোধ এবং প্রতিক্রিয়া
পাইথন ক্লায়েন্ট লাইব্রেরি লাইব্রেরি HTTP অনুরোধ এবং প্রতিক্রিয়া লগ করার জন্য আদর্শ পাইথন logging
লাইব্রেরি ব্যবহার করে। ডিফল্টরূপে, লগিং অক্ষম করা হয়।
লগিং সক্ষম করতে, পরিবেশ পরিবর্তনশীল GOOGLE_SDK_PYTHON_LOGGING_SCOPE
সেট করুন। এই এনভায়রনমেন্ট ভেরিয়েবল লেভেল logging.DEBUG
এ লগিং ইভেন্ট পরিচালনা কনফিগার করে। DEBUG বা উচ্চতর।
# Log only Ad Manager API events
export GOOGLE_SDK_PYTHON_LOGGING_SCOPE=google.ads.admanager_v1
# Log all Google library events
export GOOGLE_SDK_PYTHON_LOGGING_SCOPE=google
বিকল্পভাবে, আপনি পাইথন logging
মডিউল ব্যবহার করতে পারেন:
import logging
from google.ads import admanager_v1
logger = logging.getLogger("google.ads.admanager_v1")
logger.addHandler(logging.StreamHandler())
logger.setLevel(logging.DEBUG)
ত্রুটিগুলি পরিচালনা করুন
সমস্ত API ত্রুটি বেস ক্লাস GoogleAPIError
প্রসারিত করে।
ত্রুটির কারণ ক্ষেত্রটি অনন্যভাবে ত্রুটির ধরন সনাক্ত করে। কিভাবে ত্রুটি পরিচালনা করতে হবে তা নির্ধারণ করতে এই ক্ষেত্রটি ব্যবহার করুন।
try:
network = client.get_network(request=request)
print(network)
except GoogleAPIError as e:
# Handle error
print(e.reason)
অ্যাড ম্যানেজার এপিআই ত্রুটিগুলির মধ্যে একটি অনন্য requestId
রয়েছে যা আপনি সমস্যা সমাধানে সহায়তার জন্য সরবরাহ করতে পারেন। নিম্নলিখিত উদাহরণটি GoogleAPIError
থেকে requestId
বের করে;
except GoogleAPIError as e:
requestInfoType = "type.googleapis.com/google.rpc.RequestInfo"
requestInfo = [detail for detail in e.details if detail['@type'] == requestInfoType][0]
print(requestInfo['requestId'])
প্রক্সি সেটিংস কনফিগার করুন
পাইথন ক্লায়েন্ট লাইব্রেরি পরিবেশ পরিবর্তনশীল সেটিংস http_proxy
এবং https_proxy
সম্মান করে।