במדריך הזה מוסבר איך להגדיר OAuth 2.0 לגישה ל-API באמצעות פרטי הכניסה שלכם ותהליך העבודה במחשב או תהליך העבודה באינטרנט. צריך לבצע את השלבים האלה רק פעם אחת, אלא אם מבטלים או מוחקים את פרטי הכניסה של OAuth 2.0, או אם צריך לשנות את היקפי ההרשאות המותרים.
יצירת פרטי כניסה מסוג OAuth 2.0
פועלים לפי השלבים להגדרת פרויקט ב-Google API Console עבור Google Ads API.
מורידים את קובץ ה-JSON של הלקוח. לשם כך, קודם לוחצים על סמל הורדת לקוח OAuth ואז על הלחצן הורדת JSON במסך הבא.
שומרים את הקובץ בספריית הבית, כך שיהיה לכם עכשיו את הקובץ המקומי
~/client_secret_XXX.apps.googleusercontent.com.json(כאשר XXX יהיו ערכים ספציפיים לפרויקט שלכם). נשתמש בקובץ הזה בשלב הבא כדי להריץ את דוגמת הקוד.
הגדרת ספריית הלקוח
-
במסוף, מריצים את קוד הדוגמה
generate_user_credentials. משתמשים בדגלים של שורת הפקודה כדי להעביר אליו את קובץ ה-JSON שהורדתם בשלב הקודם.generate_user_credentials.py \ --client_secrets_path=${HOME}/client_secret_XXX.apps.googleusercontent.com.json -
בדוגמה הזו של קוד מוצגת בקשה להיכנס לכתובת 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.
תועברו לדף עם הודעה שמציינת שההרשאה הצליחה.
Your refresh token has been fetched. Check the console output for further instructions.
-
חוזרים למסוף שבו הפעלתם את קטע הקוד לדוגמה.תראו שקטע הקוד לדוגמה הסתיים ומוצג בו טוקן לרענון וכמה הוראות, ואחריהן ההוראות שצריך לפעול לפיהן כדי להגדיר את ספריית הלקוח:
Your refresh token is: 1/Yw......................................... Add your refresh token to your client library configuration as described here: https://developers.google.com/google-ads/api/docs/client-libs/python/configuration