Python

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

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

pip install google-ads-admanager

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

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

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

  1. GOOGLE_APPLICATION_CREDENTIALS एनवायरमेंट वैरिएबल.
  2. Google Cloud सीएलआई (gcloud सीएलआई) के ज़रिए सेट अप किए गए उपयोगकर्ता क्रेडेंशियल.
  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.

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

एपीआई की सभी गड़बड़ियां, बेस क्लास 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.