طرق الخدمة

اختلاف تصميم 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.