تنبيه: يتم عرض مستندات واجهة REST API. تستخدم معظم مكتبات العملاء الرسمية خدمة gRPC. يمكنك الاطلاع على
مقدمة عن REST للحصول على التفاصيل.
طرق الخدمة
يختلف تصميم Google Ads API عن بنية REST التقليدية
لأنّه يستخدم في المقام الأول طُرقًا مخصّصة، مثل search وmutate, بدلاً من
طُرق list وget وcreate وupdate وdelete الأكثر شيوعًا.
يتم التعبير عن هذه الإجراءات في عناوين URL لبروتوكول REST باستخدام تعيين HTTP
باستخدام : لفصل الفعل المخصّص عن بقية عنوان URL.
على سبيل المثال، يستخدم طلب بيانات من واجهة برمجة التطبيقات لتغيير حملة عنوان URL التالي:
https://googleads.googleapis.com/v19/customers/1234567890/campaigns:mutate
من بين الأسباب التي تدفع واجهة برمجة التطبيقات إلى استخدام طُرق مخصّصة هو تفعيل تجميع عمليات
متعدّدة في طلب واحد من واجهة برمجة التطبيقات. لا تسمح بنية REST الصارمة إلا
بتعديل حملة واحدة في كل مرة. على سبيل المثال، سيتطلّب إرسال طلب REST
update تقليدي إلى حملة
إرسال طلب HTTP PATCH واحد لكل مورد
حملة.
للسماح بتجميع العديد من العمليات معًا في نص طلب واحد،
تحدّد Google Ads API بدلاً من ذلك طريقة mutate مخصّصة لمعظم الموارد.
وبالمثل، لتفعيل عمليات القراءة المجمّعة (جلب العديد من العناصر في آنٍ واحد) من واجهة برمجة التطبيقات،
تستخدِم واجهة برمجة التطبيقات طريقة search مخصّصة مع لغة طلبات البحث في "إعلانات Google" التي تشبه لغة SQL.
توضّح صفحة الطرق الشائعة بالتفصيل
الطرق الأكثر استخدامًا في Google Ads API.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-03-04 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-03-04 (حسب التوقيت العالمي المتفَّق عليه)"],[[["The Google Ads API utilizes custom methods like `search` and `mutate` instead of standard REST methods for efficiency and batch operations."],["This approach allows for updating multiple campaigns or fetching numerous objects within a single request, unlike traditional REST."],["Custom methods are expressed in REST URLs using a colon to separate the verb from the rest of the URL, for example, `https://googleads.googleapis.com/v18/customers/1234567890/campaigns:mutate`."],["Batching operations, like updating many campaigns simultaneously, are enabled through the custom `mutate` method, improving efficiency over individual requests."],["The `search` method uses a SQL-like query language for batch reads, enabling retrieval of multiple objects in one API call."]]],["The Google Ads API uses custom methods like `search` and `mutate` instead of standard REST methods (e.g., `list`, `get`). This is indicated in URLs by a `:` separator. `Mutate` enables batching multiple operations into one request, unlike standard `update`, which handles one campaign at a time. Similarly, `search` allows fetching multiple objects in a single request, utilizing a SQL-like query language. This deviates from REST conventions to facilitate efficient batch processing and querying.\n"]]
