Python

Google, Ad Manager API के साथ इंटरैक्ट करने के लिए Python क्लाइंट लाइब्रेरी उपलब्ध कराता है. हमारा सुझाव है कि PyPI के साथ क्लाइंट लाइब्रेरी का इस्तेमाल करें.

शुरू करने के लिए, अपनी पसंद के आईडीई में नया प्रोजेक्ट बनाएं या किसी मौजूदा प्रोजेक्ट में डिपेंडेंसी जोड़ें. Google, क्लाइंट लाइब्रेरी के आर्टफ़ैक्ट को google-ads-admanager के तौर पर PyPI पर पब्लिश करता है.

pip install google-ads-admanager

क्रेडेंशियल कॉन्फ़िगर करना

पुष्टि करने के लिए, Python क्लाइंट लाइब्रेरी, OAuth2 और ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल (ADC) का इस्तेमाल करती है.

एडीसी, क्रेडेंशियल को इस क्रम में खोजता है:

  1. GOOGLE_APPLICATION_CREDENTIALS एनवायरमेंट वैरिएबल.
  2. Google Cloud CLI (gcloud CLI) की मदद से सेट अप किए गए उपयोगकर्ता क्रेडेंशियल.
  3. Google Cloud पर चलने पर, Google Cloud के संसाधन से जुड़ा सेवा खाता.

अपने ADC क्रेडेंशियल बनाने और कॉन्फ़िगर करने के लिए, पुष्टि करना देखें.

अपना पहला अनुरोध करना

हर सेवा में एक ServiceClient ऑब्जेक्ट होता है, जिसमें हर REST तरीके के लिए सिंक्रोनस और असिंक्रोनस, दोनों तरीके होते हैं. नीचे दिए गए उदाहरण में, 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)
admanager_v1_generated_network_service_get_network_sync.py

अन्य तरीकों और संसाधनों के उदाहरणों के लिए, GitHub का डेटा स्टोर करने की जगह googleapis/google-cloud-python देखें.

एचटीटीपी अनुरोध और रिस्पॉन्स को लॉग करना

Python क्लाइंट लाइब्रेरी, एचटीटीपी अनुरोधों और रिस्पॉन्स को लॉग करने के लिए, स्टैंडर्ड Python logging लाइब्रेरी का इस्तेमाल करती है. लॉगिंग की सुविधा डिफ़ॉल्ट रूप से बंद होती है.

लॉगिंग की सुविधा चालू करने के लिए, एनवायरमेंट वैरिएबल को सेट करेंGOOGLE_SDK_PYTHON_LOGGING_SCOPE. यह एनवायरमेंट वैरिएबल, logging.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

इसके अलावा, Python logging मॉड्यूल का इस्तेमाल भी किया जा सकता है:

import logging

from google.ads import admanager_v1

logger = logging.getLogger("google.ads.admanager_v1")
logger.addHandler(logging.StreamHandler())
logger.setLevel(logging.DEBUG)

गड़बड़ियां ठीक करना

एपीआई से जुड़ी सभी गड़बड़ियां, बेस क्लास GoogleAPIError को बढ़ाती हैं.

गड़बड़ी की वजह बताने वाला फ़ील्ड, गड़बड़ी के टाइप की खास तौर पर पहचान करता है. गड़बड़ी को मैनेज करने का तरीका तय करने के लिए, इस फ़ील्ड का इस्तेमाल करें.

try:
  network = client.get_network(request=request)
  print(network)
except GoogleAPIError as e:
  # Handle error
  print(e.reason)

Ad Manager API की गड़बड़ियों में एक यूनीक 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'])

प्रॉक्सी सेटिंग कॉन्फ़िगर करें

Python क्लाइंट लाइब्रेरी, एनवायरमेंट वैरिएबल की सेटिंग http_proxy और https_proxy का इस्तेमाल करती है.