طرق الخدمة

يختلف تصميم Google Ads API عن بنية REST التقليدية لأنّه يستخدم في المقام الأول طُرقًا مخصّصة، مثل search وmutate, بدلاً من طُرق list وget وcreate وupdate وdelete الأكثر شيوعًا. يتم التعبير عن هذه الإجراءات في عناوين URL لبروتوكول REST باستخدام تعيين HTTP باستخدام : لفصل الفعل المخصّص عن بقية عنوان URL.

على سبيل المثال، يستخدم طلب بيانات من واجهة برمجة التطبيقات لتغيير حملة عنوان URL التالي:

https://googleads.googleapis.com/v21/customers/1234567890/campaigns:mutate

من بين الأسباب التي تدفع واجهة برمجة التطبيقات إلى استخدام طُرق مخصّصة هو تفعيل تجميع عمليات متعدّدة في طلب واحد من واجهة برمجة التطبيقات. لا تسمح بنية REST الصارمة إلا بتعديل حملة واحدة في كل مرة. على سبيل المثال، سيتطلّب إرسال طلب REST update تقليدي إلى حملة إرسال طلب HTTP PATCH واحد لكل مورد حملة.

للسماح بتجميع العديد من العمليات معًا في محتوى طلب واحد، تحدّد Google Ads API بدلاً من ذلك طريقة mutate مخصّصة لمعظم الموارد. وبالمثل، لتفعيل عمليات القراءة المجمّعة (جلب العديد من العناصر في آنٍ واحد) من واجهة برمجة التطبيقات، تستخدِم واجهة برمجة التطبيقات طريقة search مخصّصة مع لغة طلبات البحث في "إعلانات Google" التي تشبه لغة SQL.

توضّح صفحة الطرق الشائعة بالتفصيل الطرق الأكثر استخدامًا في Google Ads API.