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

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

יצירת פרטי כניסה ל-OAuth 2.0

1. פועלים לפי השלבים להגדרת פרויקט ב-Google API Console ל-Google Ads API.

2. מורידים את קובץ ה-JSON של הלקוח בלחיצה על הסמל Download OAuth client ואז על הלחצן DOWNLOAD JSON במסך הבא.

   שומרים את הקובץ בספריית הבית, כך שיהיה לכם עכשיו את הקובץ המקומי ~/client_secret_XXX.apps.googleusercontent.com.json (כאשר XXX יהיו ערכים ספציפיים לפרויקט שלכם). בשלב הבא נשתמש בקובץ הזה כדי להריץ את דוגמת הקוד.

הגדרת ספריית הלקוח

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

1. במסוף, מריצים את דוגמת הקוד GenerateUserCredentials. משתמשים בדגלים של שורת הפקודה כדי להעביר לו את קובץ ה-JSON של OAuth 2.0 שהורדתם.

   אפשר להשתמש בפקודה הבאה כדי להריץ את דוגמת הקוד משורת הפקודה באמצעות Gradle:

   ./gradlew --console=plain --quiet runExample \
         --example="authentication.GenerateUserCredentials \
         --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"
       

2. דוגמת הקוד הזו תוביל אתכם לכתובת URL שבה תצטרכו לאשר לאפליקציה גישה לחשבון Google Ads בשמכם.

   Paste this URL in your browser:
   https://accounts.google.com/o/oauth2/auth?access_type=offline&client_id=****...
       

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

   

   תועברו לדף עם הודעה על כך שההרשאה בוצעה.

   Authorization code was successfully retrieved.
   
   Check the console output from `GenerateUserCredentials` for further instructions.
       

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

       #Mon Apr 18 09:07:51 EDT 2022
       api.googleads.refreshToken=1/Yw.........................................
       api.googleads.clientId=...........-...............apps.googleusercontent.com
       api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE
       api.googleads.clientSecret=........................
       

4. מעתיקים את השורות מהערה עם התאריך # עד סוף הפלט לקובץ ads.properties.

   מחליפים את INSERT_DEVELOPER_TOKEN_HERE באסימון הפיתוח.

   כדי להגדיר את השירות בקלות, כדאי למקם את הקובץ ads.properties בספריית הבית.