REST Resource: urlNotifications

المورد: UrlNotification

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

تمثيل JSON 
{
  "url": string,
  "type": enum(UrlNotificationType),
  "notifyTime": string
}
الحقول
url

string

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

type

enum(UrlNotificationType)

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

notifyTime

string (Timestamp format)

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

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقّة تصل إلى نانوثانية. مثال: "2014-10-02T15:01:23.045123456Z"

UrlNotificationType

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

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

الطُرق

getMetadata

 توفر هذه الطريقة بيانات وصفية حول مستند ويب.

publish

 تُعلِم هذه الطريقة بأنه تم تعديل أو حذف أحد عناوين URL.