تستند واجهة Search Ads 360 Reporting API إلى منصة حديثة وتقدّم عددًا من المفاهيم الجديدة. تم توضيح ذلك في الأقسام التالية.
الموارد
تحلّ عناصر الموارد محلّ أنواع التقارير. بدلاً من طلب أنواع تقارير محدّدة مسبقًا، يمكنك الآن طلب البحث في جميع الموارد باستخدام لغة استعلامات جديدة تشبه لغة الاستعلامات البنيوية (SQL). اطّلِع على بنية Search Ads 360 Reporting API لمعرفة المزيد من المعلومات.
إعداد تقارير عن "شبكة البحث"
توفّر "شبكة البحث" خدمة خاصة بها في واجهة برمجة التطبيقات الجديدة. تحل خدمة البحث محل خدمة التقارير القديمة. تمرّ جميع طلبات البحث من خلال
SearchAds360Service التي توفّر طريقتَين، SearchStream وSearch،
للبحث عن بيانات التقارير والمقاييس واستردادها. تعرض كلتا طريقتي البحث
جميع عناصر SearchAds360Row التي تطابق طلب البحث. راجِع إنشاء تقارير البحث للحصول على مزيد من المعلومات.
البيانات الوصفية للمورد
تتيح لك أداة SearchAds360FieldService طلب قائمة المراجع وحقول الموارد ومفاتيح التصنيف إلى قطاعات أو شرائح والمقاييس المتاحة في طرق بحث SearchAds360Service بشكل ديناميكي. اطّلِع على مقالة استرداد البيانات الوصفية للموارد لمزيد من المعلومات.
أسماء الحقول
تعرِض واجهة برمجة التطبيقات أسماء حقول متداخلة مفصولة بترميز النقطة. على سبيل المثال، campaign.id وad_group.id. يمكنك أيضًا إجراء المزيد من عمليات التداخل، على سبيل المثال،ad_group.campaign.id. اطّلِع على بنية Search Ads 360 Reporting API لمعرفة المزيد.
تستند ميزة إعداد التقارير في Search Ads 360 API السابقة إلى حقول منفصلة في
كيانات مختلفة للمفاهيم المتشابهة. على سبيل المثال، يتضمّن كلّ من تقريرَي campaign وadgroup حقل campaignId
منفصلاً.
لغة طلب البحث
تقدّم واجهة برمجة التطبيقات لغة طلبات البحث في "إعلانات شبكة البحث 360". وهي لغة مرنة تشبه SQL تسمح لك بتحديد الاستعلامات لاسترداد بيانات التقارير المحددة التي تناسب نشاطك التجاري. اطّلِع على لغة طلب البحث في "إعلانات شبكة البحث 360" لمزيد من المعلومات.
تلقّي الطلبات
في واجهة برمجة التطبيقات الجديدة، يكون للبحث خدمة خاصة به (SearchAds360Service)، ولكن تظل طلبات
GET متوفّرة في الخدمة المحدّدة لكلّ عنصر. على سبيل المثال،
يمكنك الحصول على معلومات الأعمدة المخصّصة من CustomColumnService. اطّلِع على التغييرات في التنسيق في Search Ads 360 Reporting API لمعرفة المزيد من المعلومات.
أعمدة مخصصة
في التجربة الجديدة من "إعلانات شبكة البحث 360"، يُطلق على أعمدة الصيغ والإحالات الناجحة المخصّصة اسم
الأعمدة المخصّصة. اطّلِع على مزيد من المعلومات عن الأعمدة المخصّصة. تتيح العلامة الجديدة
CustomColumnService الأعمدة المخصّصة. يمكنك طلب CustomColumn موارد يملكها أي حساب في
شجرة الحسابات، شرط أن تكون لديك الأذونات اللازمة.
إدارة الحساب
تنظّم التجربة الجديدة من "إعلانات شبكة البحث 360" الحسابات في تدرّج هرمي للحسابات الإدارية وحسابات المدراء الفرعيين وحسابات العملاء. يمثّل الحساب الإداري حساب الوكالة، في حين تمثِّل حسابات المدراء الفرعيين حسابات المعلِنين في التجربة السابقة من "إعلانات شبكة البحث 360". اطّلِع على لمحة عن الحسابات الإدارية في "إعلانات شبكة البحث 360" للاطّلاع على مزيد من المعلومات.
يمكنك الاستعلام عن شجرة الحسابات ثم إرسال طلبات لكل حساب تريد إعداد تقارير عن بياناته.
نتيجةً للتغيير في التدرّج الهرمي للحساب، تم استبدال الحقول المرتبطة بمفهوم العميل/الوكالة بدائل مناسبة لتوفير التكافؤ الوظيفي كلما أمكن ذلك. راجِع عمليات ربط الحقول للحصول على قائمة بالحقول المتأثرة وبدائلها.
عنوان الرقم التعريفي للعميل لتسجيل الدخول
login-customer-id هو عنوان جديد مطلوب عند استخدام حساب إداري للوصول إلى حساب مدير فرعي أو حساب عميل. راجِع عنوان معرّف العميل لتسجيل الدخول للحصول على مزيد من المعلومات.
تحديد الإصدار
تستخدِم Search Ads 360 Reporting API التسمية الدلالية.
هناك نُسخ رئيسية وثانوية بتنسيق
vMAJOR_MINOR. اطّلِع على إدارة الإصدارات لمعرفة المزيد من المعلومات.