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