علاقه مند به اشتراک گذاری بازخورد خود در مورد 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 است که شامل تمام حساب‌هایی است که باید تحت سلسله مراتب حساب خود مدیریت کنید. روی Continue در صفحه رضایت 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 در زمان اجرا به دست می آید.