طرق الخدمة

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

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

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

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

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

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