רוצים לשתף משוב על Google Ads API? נרשמים כדי שנוכל להזמין אתכם להשתתף במחקר על התנהגות משתמשים.

דף זה תורגם על ידי Cloud Translation API.

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

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

יצירת פרטי כניסה ל-OAuth 2.0

פועלים לפי השלבים להגדרת פרויקט ב-Google API Console ל-Google Ads API.
כותבים את מזהה הלקוח ואת הסוד של הלקוח, וחוזרים לדף הזה.

הגדרת ספריית הלקוח

מריצים את הדוגמה GenerateUserCredentials בטרמינל. מזינים את מזהה הלקוח ואת סוד הלקוח ב-OAuth 2.0 כשמתבקשים לעשות זאת.
```
dotnet run GenerateUserCredentials.csproj
```
דוגמת הקוד הזו פותחת כתובת URL באופן אוטומטי בדפדפן. אם לא נכנסתם לחשבון בדפדפן, תתבקשו להיכנס לחשבון Google בדף האינטרנט. אם כבר נכנסתם לחשבון, ההודעה על הכניסה תופעל ותופנו לכתובת URL שבה תצטרכו להעניק לאפליקציה הרשאה לגשת לחשבון Google Ads בשמכם.

נכנסים באמצעות חשבון Google שבו אתם משתמשים כדי לגשת ל-Google Ads. בדרך כלל, זהו אימייל כניסה לחשבון ניהול ב-Google Ads שמכיל את כל החשבונות שצריך לנהל בהיררכיית החשבונות שלו. לוחצים על המשך במסך ההסכמה של OAuth 2.0.

תועברו לדף עם הודעה על כך שההרשאה בוצעה.
```
Your refresh token has been fetched. Check the
console output for further instructions.
```
חוזרים למסוף שבו מריצים את דוגמת הקוד. דוגמת הקוד תושלם ותוצג לכם אסימון הרענון והוראות מסוימות, ואחריה ההוראות שצריך לפעול לפיהן כדי להגדיר את ספריית הלקוח:
```
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 = '******' />
```
חשוב גם להגדיר את הכותרת LOGIN_CUSTOMER_ID בקובץ App.config. למידע נוסף, אפשר לעיין במדריך להגדרה.
```
<add key = 'LoginCustomerId' value = 'INSERT_LOGIN_CUSTOMER_ID_HERE' />
```
אפשרויות הגדרה חלופיות מפורטות במדריך להגדרה.

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

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