با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
این راهنما نحوه راه‌اندازی OAuth 2.0 برای دسترسی API را با استفاده از اعتبارنامه‌های خود و جریان دسکتاپ یا جریان وب به شما آموزش می‌دهد. این مراحل فقط یک بار باید انجام شوند، مگر اینکه شما لغو، حذف یا نیاز به تغییر دامنه های مجاز برای اعتبارنامه OAuth 2.0 خود داشته باشید.
به شناسه مشتری و راز مشتری توجه کنید، سپس به این صفحه بازگردید.
کتابخانه مشتری را راه اندازی کنید
در ترمینال، مثال 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 در زمان اجرا به دست می آید.
تاریخ آخرین به‌روزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eStarting with version 19.0.0, the Google Ads API client library for .NET will no longer support .NET 5.0, requiring an upgrade before the end of 2024 for continued functionality.\u003c/p\u003e\n"],["\u003cp\u003eThis guide explains how to set up OAuth2 for API access using your own credentials, offering two methods: the desktop flow and the web flow.\u003c/p\u003e\n"],["\u003cp\u003eYou can simplify API calls by linking your Google Ads accounts under a single manager account and using the provided example to generate OAuth2 credentials.\u003c/p\u003e\n"],["\u003cp\u003eFor interactive applications where the Google Ads account is unknown beforehand, you can discover it at runtime using the credentials of the signed-in user, as demonstrated in the provided example.\u003c/p\u003e\n"]]],[],null,["# OAuth Desktop and Web Application Flows\n\nThis guide walks you through how to set up OAuth 2.0 for API access using your\nown credentials and either the [desktop flow](/identity/protocols/oauth2/native-app)\nor the [web flow](/identity/protocols/oauth2/web-server). These steps only need\nto be done once, unless you revoke, delete, or need to change the allowed scopes\nfor your OAuth 2.0 credentials.\n\nCreate OAuth 2.0 credentials\n----------------------------\n\n1. Follow the steps to [configure a Google API Console project for the\n Google Ads API](/google-ads/api/docs/oauth/cloud-project).\n\n2. Note the *client ID* and *client secret*, then come back to this page.\n\nSet up the client library\n-------------------------\n\n| The following steps run an interactive code example, which will require you to provide input.\n\n1. In a terminal, run the [`GenerateUserCredentials`](https://github.com/googleads/google-ads-dotnet/blob/main/Google.Ads.GoogleAds/examples/Authentication/GenerateUserCredentials)example. Enter the OAuth 2.0 client ID and client secret\n when prompted.\n\n ```\n dotnet run GenerateUserCredentials.csproj\n ```\n2. This code example opens a URL automatically in the browser. If you aren't signed in to your\n browser session, the web page will prompt you to sign in to your Google Account. If you are\n already signed in, it will skip the sign-in prompt and redirect you to a URL where you must\n authorize the app to access your Google Ads account on your behalf.\n\n Sign in with the Google Account you use to access Google Ads. Usually, this is a login\n email to a Google Ads manager account that contains all the accounts you need to manage\n under its account hierarchy. Click **Continue** on the OAuth 2.0 consent screen.\n\n You'll be taken to a page with a message indicating that the authorization\n succeeded. \n\n ```\n Your refresh token has been fetched. Check the\n console output for further instructions.\n ```\n3. Return to the console where you're running the code example. You'll see that the code\n example has completed and is displaying your refresh token and some instructions, followed by\n the instructions you'll need to follow to configure the client library:\n\n Copy the following content into your App.config file.\n\n \u003cadd key = 'OAuth2Mode' value = 'APPLICATION' /\u003e\n \u003cadd key = 'OAuth2ClientId' value = '******' /\u003e\n \u003cadd key = 'OAuth2ClientSecret' value = '******' /\u003e\n \u003cadd key = 'OAuth2RefreshToken' value = '******' /\u003e\n\n Make sure you also set the `LOGIN_CUSTOMER_ID` header in your `App.config`\n file. See [the configuration guide](/google-ads/api/docs/client-libs/dotnet/configuration#settings) to learn more. \n\n ```\n \u003cadd key = 'LoginCustomerId' value = 'INSERT_LOGIN_CUSTOMER_ID_HERE' /\u003e\n ```\n\n Refer to the [configuration guide](/google-ads/api/docs/client-libs/dotnet/configuration) for\n alternate configuration options.\n\nGenerate OAuth2 credentials for interactive applications\n--------------------------------------------------------\n\nIf you don't know the Google Ads account to make API calls to in advance, you can\ndiscover it at runtime using the credentials of the signed in user for the\nsession. See\n[`AuthenticateInAspNetCoreApplication`](https://github.com/googleads/google-ads-dotnet/tree/HEAD/Google.Ads.GoogleAds/examples/Authentication/AuthenticateInAspNetCoreApplication)\nfor an example where the currently signed in user is authenticated and the OAuth2\ncredentials are obtained at runtime."]]
