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

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

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

1. בצע את השלבים להגדרת פרויקט במסוף Google API עבור Google Ads API.

2. מורידים את קובץ ה-JSON של הלקוח על ידי לחיצה על הסמל הורדת לקוח OAuth, ואז על הלחצן Download 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 בספריית הבית.