ספריות לקוח

ספריות הלקוחות שלנו מספקות תצוגות ברמה גבוהה ובלוקים בסיסיים של הפונקציונליות של Google Ads API, וכך מאפשרות פיתוח מהיר של אפליקציות. אם אין לך ניסיון ב-API, מומלץ להתחיל מחדש.

ספריית לקוח מקור הפצה דוגמאות לקוד
Java google-ads-JavaScript Maven, tar.gz צפייה ב-GitHub
.NET google-ads-dotnet tar.gz, מיקוד צפייה ב-GitHub
PHP google-ads-php tar.gz צפייה ב-GitHub
Python google-ads-python tar.gz, מיקוד צפייה ב-GitHub
רובי google-ads-ruby gem, tar.gz, zip צפייה ב-GitHub
Perl google-ads-perl tar.gz, מיקוד צפייה ב-GitHub

גרסאות API נתמכות

בטבלה הבאה מפורטות גרסאות הספרייה הספציפיות שתומכות בכל גרסת API זמינה.

גרסת ממשק API גרסת ספריית Python גרסת ספריית רובי גרסת ספריית PHP גרסת ספריית Java גרסת ספריית .NET גרסת ספריית Perl
v11 >= 17.0.0 >= 18.0.0 >=15.1.0 >= 19.0.0 >= 12.1.0 >= 12.0.0
v10 >= 15.0.0 >= 16.0.0 >= 14.0.0 >= 17.0.0 >= 11.0.0 >= 10.0.0
v9 >= 14.1.0 >= 15.0.0 >= 12.1.0 >= 16.0.0 >= 10.2.0 >= 9.2.0

הגדרה

כל ספריית לקוח של Ads API מספקת הגדרות שונות של תצורה ושיטות טעינה שבהן ניתן להשתמש כדי להתאים אישית את התנהגותו.

הנה משתני הסביבה המשותפים לכל ספריות הלקוחות וניתן לטעון אותם כדי לקבוע את הגדרות התצורה:

  • ספריית הלקוח
    • GOOGLE_ADS_CONFIGURATION_FILE_PATH: נתיב לקובץ התצורה.
  • OAuth2
    • מצב אפליקציה
      • GOOGLE_ADS_CLIENT_ID : יש להגדיר את הערך הזה כמזהה הלקוח שלך ב-OAuth2.
      • GOOGLE_ADS_CLIENT_SECRET : יש להגדיר את הערך הזה כסוד של לקוח OAuth2.
      • GOOGLE_ADS_REFRESH_TOKEN : יש להגדיר את הערך הזה כאסימון רענון OAuth2 שנוצר מראש, אם ברצונך להשתמש שוב באסימוני OAuth2. הגדרה זו היא אופציונלית.
    • מצב חשבון שירות
      • GOOGLE_ADS_JSON_KEY_FILE_PATH : הגדרת הערך הזה לנתיב של קובץ התצורה מסוג JSON2 JSON.
      • GOOGLE_ADS_IMPERSONATED_EMAIL : יש להגדיר את הערך הזה לכתובת האימייל של החשבון שהתחזות אליו.
  • Google Ads API
    • GOOGLE_ADS_DEVELOPER_TOKEN : אפשר להגדיר זאת בקוד המפתח שלך.
    • GOOGLE_ADS_LOGIN_CUSTOMER_ID : זהו מספר הלקוח של הלקוח המורשה להשתמש בו בבקשה, ללא מקפים (-).
    • GOOGLE_ADS_LINKED_CUSTOMER_ID : הכותרת הזו נדרשת רק לשיטות שמעדכנות משאבים של ישות שקיבלו הרשאה דרך חשבונות מקושרים בממשק המשתמש של Google Ads (משאב אחד (AccountLink) ב-Google Ads API). עליך להגדיר את הערך הזה למספר הלקוח של ספק הנתונים שמעדכן את המשאבים של מספר הלקוח שצוין. יש להגדיר אותו ללא מקפים (-). למידע נוסף על חשבונות מקושרים, אפשר להיכנס למרכז העזרה.