הרשאות גישה מסוג 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. לוחצים על המשך במסך ההסכמה של 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 בבית