הרשאות גישה מסוג 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. אם כבר נכנסת לחשבון, המערכת תדלג על הכניסה ותפנה אותך לכתובת אתר שבה תתבקש לאשר בקשה לגשת לחשבון 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 הם מתקבלים בזמן הריצה.