تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يختلف تصميم 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-05 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-05 (حسب التوقيت العالمي المتفَّق عليه)"],[],["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"],null,[]]
