Method: index.inspect

الاطّلاع على الحالة المفهرَسة أو القابلة للفهرسة لعنوان URL المقدَّم في الوقت الحالي، لا تتوفر سوى حالة الإصدار في فهرس Google، ولا يمكنك اختبار قابلية فهرسة عنوان URL منشور.

طلب HTTP

POST https://searchconsole.googleapis.com/v1/urlInspection/index:inspect

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "inspectionUrl": string,
  "siteUrl": string,
  "languageCode": string
}
الحقول
inspectionUrl

string

مطلوبة. عنوان URL مؤهَّل بالكامل لفحصه. يجب أن يكون ضمن الموقع الإلكتروني المحدّد في "siteUrl".
siteUrl

string

مطلوبة. هو عنوان URL للموقع الإلكتروني كما هو محدّد في Search Console. يُرجى العِلم أنّه يجب أن تتضمّن المواقع الإلكترونية التي تحمل بادئة عنوان URL علامة / لاحقة. أمثلة: https://www.example.com/ لموقع إلكتروني يحمل بادئة عنوان URL أو sc-domain:example.com لموقع إلكتروني في النطاق.
languageCode

string

اختياريّ. رمز لغة IETF BCP-47 يمثّل اللغة المطلوبة لرسائل المشاكل المترجَمة، مثل "en-US" أو "de-CH". القيمة التلقائية هي "en-US".

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

الاستجابة لفحص حالة الفهرسة

تمثيل JSON 
{
  "inspectionResult": {
    object (UrlInspectionResult)
  }
}
الحقول
inspectionResult

object (UrlInspectionResult)

نتائج فحص عنوان URL

نطاقات الأذونات

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/webmasters
  • https://www.googleapis.com/auth/webmasters.readonly

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.