این راهنما نحوه راه‌اندازی OAuth2 برای دسترسی API را با استفاده از اعتبارنامه‌های خود و جریان دسکتاپ یا جریان وب به شما آموزش می‌دهد.
اعتبارنامه OAuth2 را برای یک حساب واحد ایجاد کنید
ساده ترین راه برای برقراری تماس با حساب های Google Ads API این است
همه حساب‌هایی را که می‌خواهید با آنها تماس‌های API برقرار کنید، تحت یک حساب مدیر Google Ads پیوند دهید.
از مثال
GenerateUserCredentialsبرای ایجاد اعتبارنامه OAuth2 برای کاربری با دسترسی به حساب مدیر استفاده کنید.از اعتبارنامه OAuth2 برای برقراری تماس با همه حساب‌هایی که باید با استفاده از Google Ads API مدیریت کنید، استفاده کنید.
این مراحل فقط یک بار باید انجام شوند، مگر اینکه شما باطل، حذف یا نیاز به تغییر دامنه های مجاز برای اعتبارنامه OAuth2 خود داشته باشید.
مرحله 1 - اعتبارنامه OAuth2 را ایجاد کنید
مراحل را برای پیکربندی پروژه Google API Console برای Google Ads API دنبال کنید.
به شناسه مشتری و راز توجه کنید، سپس به این صفحه بازگردید.
مرحله 2 - کتابخانه مشتری را راه اندازی کنید
در یک ترمینال، مثال
GenerateUserCredentialsرا اجرا کنید، که از شما می‌خواهد شناسه مشتری OAuth2 و Secret خود را دریافت کنید.این یک مثال تعاملی است که از شما نیاز به ارائه ورودی دارد .
dotnet run GenerateUserCredentials.csprojمثال از شما می خواهد که شناسه مشتری OAuth2 و Secret را ارائه دهید. جزئیات مرحله 1 را ارائه دهید.
مثال یک URL را به طور خودکار در مرورگر باز می کند. اگر وارد جلسه مرورگر خود نشده‌اید، صفحه وب از شما می‌خواهد که به حساب Google وارد شوید. اگر قبلاً وارد سیستم شده‌اید، درخواست ورود به سیستم را رد می‌کند و شما را به یک URL هدایت می‌کند که در آن از شما خواسته می‌شود به برنامه اجازه دهید از طرف شما به حساب Google Ads شما دسترسی داشته باشد.
سپس به صفحه ای منتقل می شوید که پیامی نشان می دهد که مجوز موفقیت آمیز بوده است.
رمز به‌روزرسانی شما واکشی شد. برای دستورالعمل های بیشتر خروجی کنسول را بررسی کنید.
به کنسولی که در آن مثال را اجرا می کردید برگردید. مثال باید تکمیل شده باشد و نشانه به‌روزرسانی و برخی دستورالعمل‌ها و به دنبال آن ویژگی‌هایی را که برای پیکربندی کتابخانه مشتری نیاز دارید، نمایش می‌دهد:
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 در زمان اجرا به دست می آید.