أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. يمكنك الانضمام إلى مجموعة Google searchads-api-announcements لتبقى على اطّلاع على التحسينات والإصدارات القادمة.
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
التدرّج الهرمي للأسماء
أسماء الموارد المستخدَمة في Search Ads 360 Reporting API هي هرمية، ما يعكس
تنظيم الكيانات ضمن "إعلانات شبكة البحث 360". إنّ جميع الموارد تقريبًا هي موارد فرعية
لمورد Customer
، ما يشير إلى أنّ كل طلب بيانات تقريبًا من واجهة برمجة التطبيقات يجب أن يستهدف
حسابًا معيّنًا على "إعلانات شبكة البحث 360". على سبيل المثال، الحملات والمجموعات الإعلانية والإعلانات والكلمات الرئيسية
كلها موارد فرعية لمورد العميل الجذر.
تتم الإشارة إلى كيانات Search Ads 360 Reporting API (العملاء والحملات وما إلى ذلك) من خلال أسمائهم
الموارد في جميع أنحاء واجهة برمجة التطبيقات. ومع ذلك، من المهمّ ملاحظة أنّ أسماء موارد
قد تحتوي على معرّفات موارد رقمية فريدة تُحدِّد
كل عنصر في التدرّج الهرمي. في هذه الحالات، قد يكون من المفيد تحليل اسم
المورد لاستخراج معرّفات الموارد هذه وتجميع معرّف جديد.
على سبيل المثال، راجِع اسم المورد AdGroupAd من الجدول السابق:
ويمكن تقسيم ذلك إلى أرقام تعريف الموارد الفردية (المفصولة بعلامات
أرقام تعريف المجموعة)
على النحو التالي:
مكونات اسم المورد
معرّفات الموارد
رقم تعريف العميل:
"1234567890"
رقم تعريف المجموعة الإعلانية:
"54321098765"
رقم تعريف الإعلان للمجموعة الإعلانية:
"2109876543210"
معرّفات المجموعات
"customers"
"adGroupAds"
يتيح لك تحليل الأرقام التعريفية الفردية اشتقاق أسماء موارد جديدة للإشارة إلى العميل (customers/1234567890) أو المجموعة الإعلانية (customers/1234567890/adGroupAds/54321098765) التي يخصّها إعلان المجموعة الإعلانية.
تاريخ التعديل الأخير: 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 Search Ads 360 Reporting API uses a hierarchical structure for resource names, with most resources being sub-resources of the `Customer`. Each resource has a unique numerical ID within its resource name. Resource names are relative and can be parsed to extract these IDs. These IDs allow for the derivation of new resource names, referencing parent entities, like the customer or ad group. The `resourceName` field, not `name`, is used in JSON bodies.\n"]]
