הרשאות גישה מסוג 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 מתקבלים בזמן הריצה.