تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يختلف تصميم Google Ads API عن بنية REST التقليدية
لأنّه يستخدم في المقام الأول طُرقًا مخصّصة، مثل search وmutate, بدلاً من
طُرق list وget وcreate وupdate وdelete الأكثر شيوعًا.
يتم التعبير عن هذه الإجراءات في عناوين URL لبروتوكول REST باستخدام تعيين HTTP
باستخدام : لفصل الفعل المخصّص عن بقية عنوان URL.
على سبيل المثال، يستخدم طلب بيانات من واجهة برمجة التطبيقات لتغيير حملة عنوان URL التالي:
من بين الأسباب التي تدفع واجهة برمجة التطبيقات إلى استخدام طُرق مخصّصة هو تفعيل تجميع عمليات
متعدّدة في طلب واحد من واجهة برمجة التطبيقات. لا تسمح بنية REST الصارمة إلا
بتعديل حملة واحدة في كل مرة. على سبيل المثال، سيتطلّب إرسال طلب REST
update تقليدي إلى حملة
إرسال طلب HTTP PATCH واحد لكل مورد
حملة.
للسماح بتجميع العديد من العمليات معًا في محتوى طلب واحد،
تحدّد Google Ads API بدلاً من ذلك طريقة mutate مخصّصة لمعظم الموارد.
وبالمثل، لتفعيل عمليات القراءة المجمّعة (جلب العديد من العناصر في آنٍ واحد) من واجهة برمجة التطبيقات،
تستخدِم واجهة برمجة التطبيقات طريقة search مخصّصة مع لغة طلبات البحث في "إعلانات Google" التي تشبه لغة SQL.
توضّح صفحة الطرق الشائعة بالتفصيل
الطرق الأكثر استخدامًا في Google Ads API.
تاريخ التعديل الأخير: 2025-09-26 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-09-26 (حسب التوقيت العالمي المتفَّق عليه)"],[],["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"]]
