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

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

יצירת פרטי כניסה של OAuth2 לחשבון יחיד

הדרך הקלה ביותר לבצע קריאות לחשבונות Google Ads API היא

  1. תוכלו לקשר את כל החשבונות שאליהם רוצים לבצע קריאות ל-API דרך חשבון ניהול אחד ב-Google Ads.

  2. משתמשים בדוגמה GenerateUserCredentials כדי ליצור פרטי כניסה מסוג OAuth2 עבור משתמש שיש לו גישה לחשבון הניהול.

  3. השתמשו בפרטי הכניסה של OAuth2 כדי לבצע קריאות לכל החשבונות שצריך לנהל באמצעות Google Ads API.

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

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

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

  2. מציינים את מזהה הלקוח ואת הסוד, ואז חוזרים לדף הזה.

שלב 2 – מגדירים את ספריית הלקוח

  1. בטרמינל, מריצים את הדוגמה GenerateUserCredentials, שבה תוצג בקשה למזהה הלקוח ולסוד של OAuth2.

    זו דוגמה אינטראקטיבית, שתצטרכו להזין קלט.

    dotnet run GenerateUserCredentials.csproj

  2. בדוגמה הזו תתבקשו לספק את מזהה הלקוח והסוד של OAuth2. מספקים את הפרטים משלב 1.

  3. בדוגמה תיפתח כתובת URL באופן אוטומטי בדפדפן. אם לא נכנסתם לסשן של הדפדפן, בדף האינטרנט תופיע הנחיה להיכנס לחשבון Google. אם כבר נכנסתם לחשבון, המערכת תדלג על בקשת הכניסה ותפנה אתכם לכתובת URL שבה תתבקשו לאשר לאפליקציה לגשת לחשבון Google Ads בשמכם.

    מסך הסכמה

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

    אוחזר אסימון הרענון. להוראות נוספות, יש לבדוק את הפלט של המסוף.

  5. חוזרים למסוף שבו הרצתם את הדוגמה. דוגמה:

    Copy the following content into your App.config file.

<add key = 'OAuth2Mode' value = 'APPLICATION' />
<add key = 'OAuth2ClientId' value = '******' />
<add key = 'OAuth2ClientSecret' value = '******' />
<add key = 'OAuth2RefreshToken' value = '******' />

Make sure you also set the LOGIN_CUSTOMER_ID header. See
https://developers.google.com/google-ads/api/docs/client-libs/dotnet/configuration#google_ads_api_settings
to learn more.

<add key = 'LoginCustomerId' value = 'INSERT_LOGIN_CUSTOMER_ID_HERE' />

See https://developers.google.com/google-ads/api/docs/client-libs/dotnet/configuration
for alternate configuration options.

יצירת פרטי כניסה של OAuth2 לאפליקציות אינטראקטיביות

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