הגדרת פרויקט ב-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 Client ID.

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

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

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

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

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

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

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

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

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

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

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

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

הקודם
קבלת קוד מפתח
הבא
הכנת חשבון Google Ads