Python

Google מספקת ספריית לקוח Python ליצירת אינטראקציה עם Ad Manager API. מומלץ להשתמש בספריית הלקוח עם PyPI.

כדי להתחיל, יוצרים פרויקט חדש בסביבת הפיתוח המשולבת (IDE) שבחרתם או מוסיפים את התלות לפרויקט קיים. Google מפרסמת את הארטיפקטים של ספריות הלקוח ב-PyPI בתור google-ads-admanager.

pip install google-ads-admanager

הגדרת פרטי הכניסה

ספריית הלקוח של Python משתמשת ב-OAuth2 וב-Application Default Credentials (ADC) כדי לבצע אימות.

אפשר לחפש פרטי כניסה ב-ADC במיקומים הבאים:

1. משתנה הסביבה GOOGLE_APPLICATION_CREDENTIALS.
2. פרטי הכניסה של משתמשים שהוגדרו דרך Google Cloud CLI‏ (CLI של gcloud).
3. כשהאפליקציה פועלת ב-Google Cloud, חשבון השירות שמצורף למשאב ב-Google Cloud.

במאמר הבא מוסבר איך ליצור ולהגדיר את פרטי הכניסה ל-ADC. אימות.

שליחת הבקשה הראשונה

לכל שירות יש אובייקט ServiceClient עם גם סינכרוני וגם אסינכרוני לכל method של 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.

טיפול בשגיאות

כל שגיאות ה-API מרחיבות את מחלקת הבסיס GoogleAPIError.

השדה 'סיבת השגיאה' מזהה באופן ייחודי את סוגי השגיאות. השדה הזה משמש לקביעת האופן שבו לטפל בשגיאה.

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

שגיאות ב-Ad Manager API כוללות גם את הערך הייחודי requestId, שאפשר לספק לתמיכה כדי לקבל עזרה בפתרון הבעיה. הדוגמה הבאה מחלצת את requestId מ-GoogleAPIError;

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'])

קביעת הגדרות לשרת proxy

ספריית הלקוח של Python מתייחסת להגדרות של משתני הסביבה http_proxy ו-https_proxy.