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

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

יצירת פרטי כניסה של OAuth2

1. כך מגדירים פרויקט במסוף Google API בשביל Google Ads API.

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

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

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

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

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

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

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

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

   עוברים אל כתובת ה-URL בסשן פרטי של דפדפן או בחלון פרטי. נכנסים לאותו חשבון Google שבו אתם משתמשים כדי לגשת ל-Google Ads. לוחצים על Continue (המשך) במסך ההסכמה של OAuth2.

   

3. לאחר מכן תועברו לדף עם הודעה שמציינת שההרשאה הצליחה.

   קוד ההרשאה אוחזר.

   לקבלת הוראות נוספות, צריך לבדוק את הפלט של המסוף מ-GenerateUserCredentials.

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

   #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=........................
   

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

   מחליפים את INSERT_DEVELOPER_TOKEN_HERE בקוד המפתח.

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