تتم استضافة مكتبة عملاء .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.
تستخدم مكتبة .NET في Google Ads API السمة Grpc.Net.Client كطبقة نقل تلقائية، مع الرجوع إلى Grpc.Core على المنصات غير المتوافقة. يمكنك فرض استخدام Grpc.Core من خلال ضبط UseGrpcCore على true، ولكن يُرجى العِلم أنّ Grpc.Core متوقّفة نهائيًا ولا يُقصد بها سوى الصيانة القديمة. لمزيد من المعلومات، يمكنك الاطّلاع على دليل الاستخدام الأساسي
.
إجراء أول طلب بيانات من واجهة برمجة التطبيقات
لاستخدام Google Ads API، عليك اتّخاذ عدة خطوات للوصول إلى واجهة برمجة التطبيقات وضبط حساباتك على "إعلانات Google". اتّبِع دليل البدء السريع الذي يرشدك خلال جميع الخطوات المهمة، بما في ذلك إعداد حساباتك على "إعلانات Google".
الاستخدام الأساسي
يمكنك تهيئة GoogleAdsClient باستخدام إعدادات الضبط واسترداد عميل خدمة لإجراء طلبات البيانات من واجهة برمجة التطبيقات:
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 فئات الأدوات المساعدة لتحسين سهولة استخدام واجهة برمجة التطبيقات،
بما في ذلك أدوات تحميل الوسائط والفيديوهات (UploadVideo في v27.2.0 والإصدارات الأحدث).
لمزيد من المعلومات، يمكنك الاطّلاع على الأدلة التالية:
تحسين أداء تطبيقك
للحصول على اقتراحات حول كيفية تحسين أداء تطبيقك، يمكنك الاطّلاع على دليل تحسين الأداء.