کتابخانه مشتری .NET در GitHub میزبانی می‌شود و به‌عنوان بسته NuGet توزیع می‌شود. این کتابخانه چندین ویژگی برای کمک به شما در استفاده از میانای برنامه‌سازی کاربردی ارائه می‌دهد، ازجمله مدیریت آسان‌تر اطلاعات اعتباری و ایجاد کارخواه‌های سرویس Google Ads API.
این کتابخانه از چارچوب‌های .NET زیر پشتیبانی می‌کند:
- .NET Framework 4.7.2 و نسخه‌های جدیدتر (
net472) - .NET Standard 2.1 (
netstandard2.1) - .NET 8.0 (
net8.0)
NET Standard 2.1 با چندین نسخه و پیاده‌سازی دیگر .NET سازگار است، بنابراین کتابخانه ممکن است در بسیاری از پلاتفرم‌های دیگر به‌خوبی کار کند. بااین‌حال، ما سازگاری را به‌طور رسمی آزمایش نکرده‌ایم و بنابراین به‌طور رسمی از این پلاتفرم‌ها پشتیبانی نمی‌کنیم. برای کسب اطلاعات بیشتر، به مستندات.NET Standard 2.1 مراجعه کنید.
کتابخانه Google Ads API .NET از Grpc.Net.Client به‌عنوان لایه انتقال پیش‌فرض استفاده می‌کند،
و در پلاتفرم‌های پشتیبانی‌نشده از Grpc.Core به‌عنوان جایگزین استفاده می‌کند. درحالی‌که می‌توانید با تنظیم UseGrpcCore روی true، استفاده از Grpc.Core را اجباری کنید، توجه داشته باشید که Grpc.Core منسوخ شده است و فقط برای نگهداری قدیمی درنظر گرفته شده است. برای کسب اطلاعات بیشتر،
راهنمای استفاده پایه را ببینید.
اولین فراخوانی میانای برنامه‌سازی کاربردی را انجام دهید
برای استفاده از Google Ads API، باید چند مرحله را برای دسترسی به API و پیکربندی حساب‌های Google Ads خود انجام دهید. راهنمای راه‌اندازی سریع را دنبال کنید که شما را در تمام مراحل مهم، ازجمله راه‌اندازی حساب‌های Google Ads، راهنمایی می‌کند.
استفاده پایه
GoogleAdsClient را با تنظیمات پیکربندی خود مقداردهی اولیه کنید و یک سرویس گیرنده برای برقراری تماس‌های API بازیابی کنید:
GoogleAdsClient client = new GoogleAdsClient();
GoogleAdsServiceClient googleAdsService =
client.GetService(Services.V26.GoogleAdsService);
برای کسب اطلاعات بیشتر درباره نحوه استفاده از کتابخانه مشتری .NET، به راهنمای استفاده پایه مراجعه کنید.
صدور مجوز و اصالت‌سنجی
کتابخانه کارخواه .NET از چندین روش برای اصالت‌سنجی و
مجوزدهی پشتیبانی می‌کند، ازجمله اعتبارنامه‌های کاربر OAuth 2.0 (برای برنامه‌های
رومیزی و وب)، حساب‌های سرویس، اعتبارنامه‌های پیش‌فرض برنامه (v24.1.0 و
نسخه‌های جدیدتر)، و تزریق دستی اعتبارنامه (v27.0.0 و نسخه‌های جدیدتر). برای کسب اطلاعات بیشتر، به راهنمای
مجوزدهی و اصالت‌سنجی مراجعه کنید.
پیکربندی و گزارش‌گیری
کتابخانه کارخواه .NET از چندین گزینه پیکربندی
و ثبت وقایع بااستفاده از اشیای زمان اجرا، فایل‌های App.config،
فایل‌های پیکربندی JSON، یا متغیرهای محیطی پشتیبانی می‌کند. درصورتی‌که لازم باشد رفتار ثبت گزارش کتابخانه مشتری را اصلاح کنید، به راهنمای رهگیر gRPC سفارشی مراجعه کنید.
برنامه‌های کمکی
کتابخانه کارخواه .NET شامل کلاس‌های ابزاری برای بهبود قابلیت استفاده از API است،
ازجمله یاری‌رسان‌های بارگذاری رسانه و ویدیو (UploadVideo در v27.2.0 و نسخه‌های جدیدتر).
برای کسب اطلاعات بیشتر، به راهنماهای زیر مراجعه کنید:
تنظیم دقیق عملکرد برنامه
برای دریافت توصیه‌هایی درباره نحوه بهینه‌سازی عملکرد برنامه‌تان، به راهنمای بهینه‌سازی عملکرد مراجعه کنید.