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