نظرة عامة على واجهة REST
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكن طلب Google Ads API باستخدام gRPC أو REST. توفّر كلتا الواجهتين تصميمًا يستند إلى الموارد تتم مشاركته مع واجهات برمجة التطبيقات الأخرى في Google Cloud.
ننصحك باستخدام مكتبات العملاء الرسمية من Google
حيثما أمكن ذلك. وتوفّر هذه المكتبات تعليمات برمجية آمنة من حيث النوع ومناسبة لكل لغة متوافقة، كما أنّها تتعامل مع العديد من التفاصيل الأساسية المتعلقة بالتواصل مع واجهة برمجة التطبيقات (مثل إعدادات المهلة وتقسيم النتائج على عدّة صفحات والمصادقة). تتضمّن مكتبات العملاء أيضًا مجموعة شاملة من أمثلة الرموز والأدوات المساعدة التي تساعد في تنفيذ المهام الشائعة، مثل إنشاء أسماء الموارد والتعامل مع أقنعة الحقول.
يقدّم هذا الدليل تفاصيل خاصة بـ REST ويوضّح المعلومات التي تحتاج إلى معرفتها لاستدعاء واجهة REST مباشرةً، بدون استخدام مكتبة برامج عميل متوافقة مع Google. قد يكون هذا الدليل مفيدًا إذا كنت تكتب رمزًا مخصّصًا لاستخدام REST مباشرةً أو تستخدم مكتبة برامج HTTP تابعة لجهة خارجية.
تاريخ التعديل الأخير: 2026-01-28 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2026-01-28 (حسب التوقيت العالمي المتفَّق عليه)"],[],["The Google Ads API utilizes gRPC or REST interfaces, sharing a resource-oriented design. Using Google's client libraries is highly recommended for type-safe code, handling communication details like timeouts, pagination, and authentication. The official client libraries use gRPC, except for the Perl library, which uses REST. This guide details using REST directly without client libraries, useful for custom code or third-party HTTP clients. It focuses on information outside of what the official client libraries cover.\n"]]
