הגדרת פרויקט ב-Google API Console

צריך פרויקט במסוף Google API כדי ליצור פרטי כניסה מסוג OAuth 2.0, להגדיר מסך הסכמת משתמש ולהפעיל את Google Ads API עבור האפליקציה.

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

יש לבחור או ליצור פרויקט ב-Google API Console

אם כבר יש לכם פרויקט במסוף Google API ואתם רוצים להשתמש בו כדי ליצור פרטי כניסה, תוכלו לדלג למאמר יצירה של מזהה לקוח וסוד לקוח.

כדי ליצור פרויקט:

  • עוברים אל Google API Console.
  • לוחצים על Create Project.
  • צריך להזין שם או לאשר את ההצעה שנוצרה
  • אישור או עריכה של כל השדות שנותרו
  • לחץ על צור.

אם החיוב מופעל, בוחרים חשבון לחיוב לפרויקט החדש. השימוש ב-Google Ads API לא כרוך בתשלום, אבל יש מכסה על המספר הכולל של הפרויקטים ב-Cloud.

אם אתם משתמשים בפרויקט קיים במסוף Google API, והגדרתם בעבר מסך הסכמה ל-OAuth, אפשר לדלג על השלב הזה ולשנות את מסך ההסכמה במקום זאת על ידי הוספת היקף OAuth 2.0 של Google Ads API.

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

  1. פותחים את הדף Consent Screen ובוחרים את הפרויקט הרצוי בתפריט הנפתח שבחלק העליון של הדף.
  2. בוחרים באפשרות סוג משתמש ולוחצים על יצירה.
  3. ממלאים את טופס מסך ההסכמה. אפשר לערוך את המידע הזה מאוחר יותר במקרה הצורך. בסיום, לוחצים על שמירה והמשך.
  4. בדף הבא, לוחצים על הוספה או הסרה של היקפים.
  5. גוללים למטה ומזינים את הפרטים הבאים בשדה הוספה ידנית של היקפי הרשאות:

    https://www.googleapis.com/auth/adwords

  6. לוחצים על הוספה לטבלה.
  7. מוסיפים עוד היקפי הרשאות לפרויקט ולוחצים על עדכון.
  8. לוחצים על שמור והמשך.
  9. אם אתם לא מתכננים לפרסם את הפרויקט באופן מיידי, צריך להוסיף את כתובת האימייל של כל חשבון משתמש שאתם עשויים להשתמש בו לבדיקה ואז ללחוץ על שמירה והמשך.
  10. בודקים את דף הסיכום ולוחצים על חזרה למרכז הבקרה.
  1. פותחים את הדף Consent Screen ובוחרים את הפרויקט הרצוי בתפריט הנפתח שבחלק העליון של הדף.
  2. לוחצים על עריכת האפליקציה.
  3. לוחצים על שמירה והמשך בטופס מסך ההסכמה של OAuth.
  4. בדף הבא, לוחצים על הוספה או הסרה של היקפים.
  5. גוללים למטה ומזינים את הפרטים הבאים בשדה הוספה ידנית של היקפי הרשאות:

    https://www.googleapis.com/auth/adwords

  6. לוחצים על הוספה לטבלה.
  7. לוחצים על שמור והמשך.
  8. לוחצים על שמירה והמשך בטופס בדיקת המשתמשים.
  9. בודקים את דף הסיכום ולוחצים על חזרה למרכז הבקרה.

יצירת מזהה לקוח וסוד לקוח

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

אחרי שקובעים את סוג האפליקציה, צריך לפעול לפי ההוראות הבאות כדי ליצור את מזהה הלקוח ואת סוד הלקוח של OAuth 2.0:

  1. פותחים את הדף Credentials. בוחרים פרויקט שנוצר בעבר או יוצרים פרויקט חדש.

  2. במסך Credentials, לוחצים על CREATE CREDENTIALS ובוחרים באפשרות OAuth לקוח ID.

    • אם עדיין לא הגדרתם מסך הסכמה ל-OAuth לפרויקט הזה, צריך ללחוץ על הגדרת מסך ההסכמה.

      • בוחרים את סוג המשתמש ולוחצים על יצירה.

      • ממלאים את הטופס הראשוני. אפשר לערוך את המידע הזה מאוחר יותר במקרה הצורך. כשמסיימים, לוחצים על Save.

    • כדי להמשיך, צריך לחזור אל Credentials > CREATE CREDENTIALS > OAuth client ID.

  3. בוחרים באפשרות אפליקציה למחשב או אפליקציית אינטרנט בתור סוג האפליקציה, בהתאם לתרחיש לדוגמה שלכם. במדריך הזה אנחנו משתמשים באפליקציה למחשב בתור סוג האפליקציה.

  4. מזינים שם לאפליקציה ולוחצים על יצירה.

  5. בדף האישור, מעתיקים את מספר הלקוח ואת סוד הלקוח ללוח העריכה כדי להגדיר את ספריית הלקוח מאוחר יותר. בנוסף, מורידים את פרטי הכניסה בפורמט JSON לקובץ בשם credentials.json.

הפעלת Google Ads API בפרויקט

כדי להפעיל את Google Ads API בפרויקט:

  1. פותחים את ספריית ה-API ב-Google API Console. אם מופיעה בקשה, בוחרים פרויקט או יוצרים פרויקט חדש. בספריית ה-API מופיעה רשימה של כל ממשקי ה-API הזמינים, בקיבוץ לפי משפחת מוצרים ופופולריות.

  2. משתמשים בחיפוש כדי למצוא את Google Ads API אם הוא לא מופיע ברשימה.

  3. בוחרים את Google Ads API ולוחצים על הלחצן הפעלה.