نظرة عامة على واجهة REST

يمكن طلب Google Ads API باستخدام gRPC أو REST. توفّر كلتا الواجهتين تصميمًا يستند إلى الموارد مشتركًا مع واجهات Google Cloud API الأخرى.

ننصحك باستخدام مكتبات البرامج الرسمية من Google حيثما أمكن. وتوفّر هذه المكتبات تعليمات برمجية اصطلاحية وآمنة من حيث النوع في كل لغة متوافقة، كما أنّها تتعامل مع العديد من التفاصيل المنخفضة المستوى المتعلقة بالتواصل مع واجهة برمجة التطبيقات (مثل إعدادات المهلة والتقسيم إلى صفحات لمجموعة النتائج والمصادقة). تتضمّن مكتبات العملاء أيضًا مجموعة شاملة من أمثلة الرموز والأدوات المساعدة التي تساعد في تنفيذ المهام الشائعة، مثل إنشاء أسماء الموارد والتعامل مع حقول الأقنعة.

يقدّم هذا الدليل تفاصيل خاصة بـ REST ويوضّح المعلومات التي تحتاج إلى معرفتها لاستدعاء واجهة REST مباشرةً، بدون استخدام مكتبة برامج عميل متوافقة مع Google. قد يكون هذا الدليل مفيدًا إذا كنت تكتب رمزًا مخصّصًا لاستخدام REST مباشرةً أو تستخدم مكتبة برامج HTTP تابعة لجهة خارجية.