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

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

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

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