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

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

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

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