تنبيه: يتم عرض مستندات واجهة REST API. تستخدم معظم مكتبات العملاء الرسمية خدمة gRPC. يمكنك الاطلاع على
مقدمة عن REST للحصول على التفاصيل.
طرق الخدمة
اختلاف تصميم Google Ads API عن بنية REST التقليدية
لأنها تستخدم بشكل أساسي طرق مخصّصة، مثل search وmutate, بدلاً منها
من طرق list وget وcreate وupdate وdelete الأكثر تقليدية.
يتم التعبير عن هذه الإجراءات في عناوين URL REST باستخدام تعيين HTTP.
: لفصل الفعل المخصّص عن باقي عنوان URL.
على سبيل المثال، يستخدم طلب البيانات من واجهة برمجة التطبيقات mutate للحملة عنوان URL التالي:
https://googleads.googleapis.com/v17/customers/1234567890/campaigns:mutate
إنّ أحد أسباب استخدام واجهة برمجة التطبيقات للطرق المخصّصة هو تفعيل تجميع
العمليات في طلب واجهة برمجة تطبيقات واحد. ولن تسمح الدلالة الدلالية الصارمة لـ REST إلا
تحديث حملة واحدة في كل مرة. راحة تقليدية
update إلى
على سبيل المثال، إرسال طلب تصحيح HTTP واحد لكل حملة
المصدر.
للسماح بتجميع العديد من العمليات معًا في نص طلب واحد،
تحدّد Google Ads API بدلاً من ذلك طريقة mutate مخصّصة لمعظم الموارد.
وبالمثل، لتفعيل القراءات المجمّعة (جلب العديد من الكائنات في وقت واحد) من واجهة برمجة التطبيقات،
تستخدم واجهة برمجة التطبيقات طريقة search مخصّصة مع طلب بحث في "إعلانات Google" يشبه SQL.
اللغة:
تتناول صفحة الطرق الشائعة بالتفصيل
من أكثر الطرق استخدامًا في Google Ads API.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-08-22 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-08-22 (حسب التوقيت العالمي المتفَّق عليه)"],[[["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."]]],[]]
