تعديلات على واجهة برمجة التطبيقات في خدمة Search Console

الأربعاء في 9 كانون الأول (ديسمبر) 2020

قبل بضعة أشهر، أعلنّا عن ترقية البنية الأساسية لواجهة برمجة التطبيقات لتحسين أداء Search Console API نظرًا لتزايد الطلب عليها. ويسرّنا اليوم الإعلان عن بعض التعديلات الإضافية التي سيتم طرحها قريبًا:

  • إضافة فلتر أخبار وبيانات حديثة إلى Search Console API
  • إتاحة المواقع الإلكترونية في النطاق في Sitemaps API
  • إرشادات حول كيفية نقل مستند Discovery

في حال كنت تجري طلباتك الخاصة من واجهة برمجة التطبيقات، يُرجى مواصلة القراءة.

فلتر الأخبار والبيانات الحديثة في Search Console API

يعرض تقرير الأداء البيانات الحديثة التي مرّ عليها أقل من يوم. وأصبح بإمكانك الآن أيضًا الوصول إلى هذه البيانات من خلال واجهة برمجة التطبيقات عن طريق ضبط معلَمة الطلب dataState مع قيمة all. ستتضمّن البيانات التي تحصل عليها لهذه القيمة أيضًا بيانات حديثة ليست نهائية بعد. إذا أردت الحصول على البيانات النهائية فقط، يمكنك ضبط هذه المعلَمة مع القيمة final أو عدم ضبطها على الإطلاق، وستحصل على البيانات النهائية فقط بشكل تلقائي.

قبل بضعة أشهر، أضفنا علامة التبويب "الأخبار" في فلتر البحث إلى تقرير الأداء. تتوفر هذه المعلومات الآن أيضًا في واجهة برمجة التطبيقات، ويمكنك الوصول إليها من خلال ضبط قيمة معلَمة searchType في الطلب على news.

إتاحة المواقع الإلكترونية في النطاق في Sitemaps API

تعرض واجهة Sitemaps API الآن المواقع الإلكترونية على النطاق، مثل Search Console API. يمكنك إرسال طلبات بحث عن ملفات خرائط الموقع وإضافتها وحذفها على الموقع الإلكتروني على النطاق، على سبيل المثال:

GET https://www.googleapis.com/webmasters/v3/sites/sc-domain:example.com/sitemaps

نقل مستند Disovery

لن تعود البيانات المتعلقة بمستند Discovery في مشرفي المواقع متاحة إذا كنت تنفذ طلبات بحث في Search Console API باستخدام مكتبة واجهة برمجة تطبيقات خارجية، أو طلبات بحث في مستند Discovery المتعلق بـ Webmasters API مباشرةً، ستحتاج إلى تعديل طلبات البيانات الخاصة بواجهة برمجة التطبيقات لتضمين التغييرات التالية.

التغييرات في مكتبة واجهة برمجة التطبيقات

للاطّلاع على آخر التغييرات في مكتبة واجهة برمجة التطبيقات، راجِع أدلة البدء السريع حول Java وPython للحصول على الإرشادات المحدّثة لاستخدام واجهة برمجة التطبيقات.

Java

بالنسبة إلى جميع عمليات الاستيراد المتعلقة بخدمة مشرفي المواقع، يمكنك تغيير حزمة webmasters إلى حزمة searchconsole.v1، واسم الخدمة Webmasters إلى SearchConsole. أمثلة:

  • استيراد خدمة واجهة برمجة التطبيقات:

    import com.google.api.services.webmasters.Webmasters;

    import com.google.api.services.searchconsole.v1.SearchConsole;

  • استيراد عنصر استجابة:

    import com.google.api.services.webmasters.model.WmxSite;

    import com.google.api.services.searchconsole.v1.model.WmxSite;

يُرجى العلم بأنّه باستثناء عنصر الخدمة، لم يتم إجراء أي تغيير على عناصر واجهة برمجة التطبيقات الأخرى، بل تم تغيير الحزمة فقط.

Python

عند إنشاء عنصر خدمة مشرفي المواقع، ننصحك بإجراء التغيير التالي:

webmasters_service = build('webmasters', 'v3', http=http)

webmasters_service = build('searchconsole', 'v1', http=http)

نكرّر أننا لم نجرِ أي تغيير على طريقة عمل العناصر.

طلب بحث مباشر حول مستند Discovery

تشمل تغييرات طلب البحث حول مستند Discovery ما يلي:

  • تغيير عناوين URL

    https://www.googleapis.com/discovery/v1/apis/webmasters/v3/rest

    https://searchconsole.googleapis.com/$discovery/rest

  • تغيير المحتوى
    • تم تغيير الحقل name من webmasters إلى searchconsole.
    • تم تغيير الحقل version من v3 إلى v1.

إذا كانت لديك أي أسئلة، يمكنك طرحها في منتدى "مجموعة خدمات بحث Google‏" أو على Twitter.

الناشرون: "ناتي يوسيفيان" و"جلعاد قمر" و"مايكل هوزمان"، فريق Search Console