طرق الخدمة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
اختلاف تصميم Google Ads API عن بنية REST التقليدية
لأنها تستخدم بشكل أساسي طرق مخصّصة، مثل search وmutate, بدلاً منها
من طرق list وget وcreate وupdate وdelete الأكثر تقليدية.
يتم التعبير عن هذه الإجراءات في عناوين URL REST باستخدام تعيين HTTP.
: لفصل الفعل المخصّص عن باقي عنوان URL.
على سبيل المثال، يستخدم طلب البيانات من واجهة برمجة التطبيقات mutate للحملة عنوان URL التالي:
إنّ أحد أسباب استخدام واجهة برمجة التطبيقات للطرق المخصّصة هو تفعيل تجميع
العمليات في طلب واجهة برمجة تطبيقات واحد. ولن تسمح الدلالة الدلالية الصارمة لـ REST إلا
تحديث حملة واحدة في كل مرة. راحة تقليدية
update إلى
على سبيل المثال، إرسال طلب تصحيح HTTP واحد لكل حملة
المصدر.
للسماح بتجميع العديد من العمليات معًا في نص طلب واحد،
تحدّد Google Ads API بدلاً من ذلك طريقة mutate مخصّصة لمعظم الموارد.
وبالمثل، لتفعيل القراءات المجمّعة (جلب العديد من الكائنات في وقت واحد) من واجهة برمجة التطبيقات،
تستخدم واجهة برمجة التطبيقات طريقة search مخصّصة مع طلب بحث في "إعلانات Google" يشبه SQL.
اللغة:
تتناول صفحة الطرق الشائعة بالتفصيل
من أكثر الطرق استخدامًا في Google Ads API.
تاريخ التعديل الأخير: 2025-10-16 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-10-16 (حسب التوقيت العالمي المتفَّق عليه)"],[],["The Google Ads API uses custom methods like `search` and `mutate` instead of standard REST methods (e.g., `list`, `get`). This is indicated in URLs by a `:` separator. `Mutate` enables batching multiple operations into one request, unlike standard `update`, which handles one campaign at a time. Similarly, `search` allows fetching multiple objects in a single request, utilizing a SQL-like query language. This deviates from REST conventions to facilitate efficient batch processing and querying.\n"]]
