نظرة عامة على واجهة REST
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكن استدعاء Google Ads API باستخدام gRPC أو REST. تعرض كلتا الواجهتين تصميمًا مستندًا إلى الموارد تتم مشاركته مع واجهات برمجة تطبيقات Google Cloud الأخرى.
ننصحك باستخدام مكتبات العملاء الرسمية من Google
كلما أمكن ذلك. وتوفّر هذه المكتبات رموزًا اصطلاحية تمنع أخطاء الكتابة في كل لغة متوافقة، كما تعالج العديد من التفاصيل المنخفضة المستوى للتواصل مع واجهة برمجة التطبيقات (مثل إعدادات المهلة وتقسيم مجموعة النتائج إلى صفحات والمصادقة). تتضمّن مكتبات العملاء أيضًا مجموعة شاملة من أمثلة الرموز البرمجية والأدوات المساعدة التي تساعد في تنفيذ المهام الشائعة، مثل إنشاء أسماء الموارد والتعامل مع أقنعة الحقول.
يقدّم هذا الدليل تفاصيل خاصة بـ REST ويشرح ما تحتاج إلى معرفته
لاستدعاء واجهة REST مباشرةً، بدون استخدام مكتبة برمجية للعميل
معتمَدة من Google. قد يكون هذا الدليل مفيدًا إذا كنت تكتب رمزًا مخصّصًا
لاستخدام REST مباشرةً أو باستخدام مكتبة عميل HTTP تابعة لجهة خارجية.
تاريخ التعديل الأخير: 2026-10-21 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2026-10-21 (حسب التوقيت العالمي المتفَّق عليه)"],[],["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"]]
