השלבים ליצירה ולהגדרה של פרויקט ב-Google API Console תלויים בסוג תרחיש ההרשאה של OAuth 2.0 שאתם יוצרים באפליקציה. בוחרים את תרחיש ההרשאה שרוצים ליצור. המדריך הזה יותאם אישית על סמך הבחירה שלכם.
כדי ליצור פרטי כניסה של OAuth 2.0 ולהפעיל את Google Ads API באפליקציה, צריך פרויקט ב-Google API Console.
פרטי הכניסה נדרשים לצורך אימות והרשאה של משתמשי Google Ads על ידי שרתי Google. פרטי הכניסה האלה מאפשרים ליצור אסימוני OAuth לשימוש בקריאות ל-API.
אפשר להשתמש באותו קוד מפתח לכמה פרויקטים, אבל כל פרויקט יכול להשתמש רק בקוד מפתח אחד.
בוחרים פרויקט קיים או יוצרים פרויקט חדש ב-Google API Console.
פועלים לפי ההוראות ליצירת פרויקט. הפעלת החיוב בפרויקט היא אופציונלית. אם החיוב מופעל, בוחרים חשבון לחיוב עבור הפרויקט החדש. אין חיוב על השימוש ב-Google Ads API, אבל יש מכסה על המספר הכולל של פרויקטים ב-Cloud.
הפעלת Google Ads API בפרויקט
כדי להפעיל את Google Ads API בפרויקט, מבצעים את הפעולות הבאות:
פותחים את API Library ב-Google API Console. אם מתבקשים, בוחרים פרויקט או יוצרים פרויקט חדש. בספריית ה-API מפורטים כל ממשקי ה-API הזמינים, מקובצים לפי משפחת מוצרים ופופולריות.
אם Google Ads API לא מופיע ברשימה, אפשר להשתמש בחיפוש כדי למצוא אותו.
בוחרים באפשרות Google Ads API ולוחצים על הלחצן הפעלה.
מגדירים את מסך ההסכמה של OAuth
כשמשתמשים ב-OAuth 2.0 לאימות, Google מציגה למשתמש מסך הסכמה שכולל סיכום של הפרויקט, המדיניות שלו והיקפי ההרשאות המבוקשים לגישה. הגדרת מסך ההסכמה ל-OAuth של האפליקציה קובעת מה מוצג למשתמשים ולבודקי האפליקציה, ורושמת את האפליקציה כדי שתוכלו לפרסם אותה בהמשך.
פועלים לפי ההוראות כדי להגדיר מסך הסכמה ל-OAuth עבור האפליקציה ולהוסיף את https://www.googleapis.com/auth/adwords כהיקף OAuth.
יצירת מזהה לקוח וסוד לקוח
אפשר לדלג על השלב הזה אם אתם משתמשים בפרויקט קיים ב-Google API Console שכבר יש לו Client-ID וסוד לקוח שנוצרו. אחרת, יוצרים מזהה לקוח וסוד לקוח לפי ההוראות. אפשר לבחור באפשרות Desktop app או באפשרות Web application בתור סוג האפליקציה. אחרי שיוצרים את לקוח OAuth 2.0, מורידים את קובץ ה-JSON של הלקוח. לשם כך, קודם לוחצים על הסמל הורדת לקוח OAuth ואז על הלחצן הורדת JSON במסך הבא.