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