حزمة google.indexing.v3

الفهرس

UrlService

تسمح هذه الواجهة لمطوّري برامج الويب بإرسال إشعار إلى Google حول تغيّرات الحالة في عناوين URL التي يملكونها.

GetUrlNotificationMetadata

rpc GetUrlNotificationMetadata(GetUrlNotificationMetadataRequest) returns (UrlNotificationMetadata)

توفر هذه الطريقة بيانات وصفية حول مستند ويب. ولا يمكن استخدام هذه الطريقة إلا للبحث عن عناوين URL التي سبق ظهورها في إشعارات ناجحة لواجهة برمجة التطبيقات للفهرسة. وتتضمن هذه الطريقة أحدث UrlNotification تلقّته واجهة برمجة التطبيقات هذه.

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

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/indexing
PublishUrlNotification

rpc PublishUrlNotification(PublishUrlNotificationRequest) returns (PublishUrlNotificationResponse)

يتم استخدام هذه الرسالة كإشعار بأنه قد تم تعديل أحد عناوين URL أو حذفه.

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

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/indexing

GetUrlNotificationMetadataRequest

مُدخلات استدعاء GetUrlNotificationMetadata

الحقول
url

string

عنوان URL الذي يتم البحث عنه

PublishUrlNotificationRequest

مُدخلات PublishUrlNotification

الحقول
url_notification

UrlNotification

وصف للحدث الخاص بعنوان URL الذي يتم إرسال إشعار عنه

PublishUrlNotificationResponse

مُخرجات PublishUrlNotification

الحقول
url_notification_metadata

UrlNotificationMetadata

وصف للأحداث الخاصة بالإشعارات التي تم تلقّيها عن عنوان URL هذا

UrlNotification

UrlNotification هو المورد المستخدَم في كل طلبات البيانات من واجهة برمجة التطبيقات للفهرسة. ويصف هذا المورد حدثًا واحدًا في دورة حياة مستند الويب.

الحقول
url

string

يمثل الهدف من هذا الإشعار. يجب أن يملك ناشر هذا الإشعار عنوان URL، وفي حال الإشعارات بخصوص URL_UPDATED، يجب أن يسمح العنوان لمحرك البحث Google بالزحف إليه.

type

UrlNotificationType

يمثل الحدث الذي يطرأ على دورة حياة عنوان URL والذي يتم إرسال إشعار إلى Google بشأنه.

notify_time

Timestamp

الطابع الزمني لإنشاء هذا الإشعار. يجب على المستخدمين عدم تحديده، وأن يتم تجاهل هذا الحقل في وقت الطلب.

UrlNotificationMetadata

ملخّص لأحدث إشعارات واجهة برمجة التطبيقات للفهرسة التي تم تلقّيها بنجاح والمرتبطة بعنوان URL محدد.

الحقول
url

string

عنوان URL الذي تشير إليه هذه البيانات الوصفية

latest_update

UrlNotification

أحدث إشعار تم تلقّيه من النوع URL_UPDATED

latest_remove

UrlNotification

أحدث إشعار تم تلقّيه من النوع URL_REMOVED

UrlNotificationType

يحدّد هذا الإشعار الأحداث المختلفة التي قد تطرأ على عنوان URL معيّن.

عمليات التعداد
URL_NOTIFICATION_TYPE_UNSPECIFIED غير محدد
URL_UPDATED تمّ تعديل عنوان URL المحدد (مستند الويب).
URL_DELETED تمّ حذف عنوان URL المحدد (مستند الويب).