تستند Search Ads 360 Reporting API إلى منصة حديثة وهي تقدّم عددًا من المفاهيم الجديدة. ويتم توضيح ذلك في الأقسام التالية.
المراجِع
تحل عناصر الموارد محل أنواع التقارير. بدلاً من طلب أنواع تقارير محددة مسبقًا، يمكنك الآن الاستعلام عن جميع الموارد باستخدام لغة طلب بحث جديدة تشبه SQL. اطّلِع على بنية واجهة برمجة التطبيقات لإعداد التقارير في "إعلانات شبكة البحث 360" لمزيد من المعلومات.
البحث في التقارير
يوفّر "بحث Google" خدمة خاصة به في واجهة برمجة التطبيقات الجديدة. تحلّ خدمة "بحث Google" محلّ خدمة "التقارير" القديمة. تظهر جميع طلبات البحث من خلال SearchAds360Service، وهي تقدّم طريقتَين، SearchStream وSearch، للبحث عن بيانات ومقاييس إعداد التقارير واستردادها. تعرض كلتا طريقتَي البحث
جميع عناصر SearchAds360Row التي تتطابق مع طلب البحث. اطّلع على
إنشاء تقارير البحث للحصول على مزيد من المعلومات.
البيانات الوصفية للموارد
تتيح لك أداة SearchAds360FieldService طلب كتالوج الموارد وحقول الموارد ومفاتيح التصنيف والمقاييس المتوفّرة في
SearchAds360Service طريقة البحث بشكل ديناميكي. راجع
استرداد البيانات الوصفية للموارد
لمعرفة المزيد من المعلومات.
أسماء الحقول
تقدّم واجهة برمجة التطبيقات أسماء الحقول المتداخلة مفصولة بالرمز النقطي. على سبيل المثال، campaign.id وad_group.id. يمكنك أيضًا تضمين المزيد من العناصر،
على سبيل المثال، ad_group.campaign.id. اطّلِع على بنية واجهة برمجة التطبيقات لإعداد التقارير في "إعلانات شبكة البحث 360" لمزيد من المعلومات.
يستند إعداد التقارير في 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. راجِع تحديد الإصدارات لمزيد من المعلومات.