The object of this notification. The URL must be owned by the publisher of this notification and, in case ofURL_UPDATEDnotifications, itmustbe crawlable by Google.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-10-31 UTC."],[[["\u003cp\u003e\u003ccode\u003eUrlNotification\u003c/code\u003e is the resource used for communicating URL updates and deletions to Google's Indexing API.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eUrlNotification\u003c/code\u003e object utilizes \u003ccode\u003eurl\u003c/code\u003e, \u003ccode\u003etype\u003c/code\u003e, and \u003ccode\u003enotifyTime\u003c/code\u003e fields to provide details about web document events.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eUrlNotificationType\u003c/code\u003e defines the specific event being communicated, such as URL updates (\u003ccode\u003eURL_UPDATED\u003c/code\u003e) or deletions (\u003ccode\u003eURL_DELETED\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eThe Indexing API provides methods for publishing URL notifications and retrieving web document metadata.\u003c/p\u003e\n"]]],["The `UrlNotification` resource represents an event in a web document's lifecycle, used within the Indexing API. It includes the document's `url` (which must be owned by the publisher and crawlable if `URL_UPDATED`), the `type` of event (`URL_UPDATED` or `URL_DELETED`), and `notifyTime`. The API provides `publish` to send updates or deletions. A `getMetadata` method provides web document's information. `UrlNotificationType` defines the event type.\n"],null,["# REST Resource: urlNotifications\n\n- [Resource: UrlNotification](#UrlNotification)\n - [JSON representation](#UrlNotification.SCHEMA_REPRESENTATION)\n- [UrlNotificationType](#UrlNotificationType)\n- [Methods](#METHODS_SUMMARY)\n\nResource: UrlNotification\n-------------------------\n\n`UrlNotification` is the resource used in all Indexing API calls. It describes one event in the life cycle of a Web Document.\n\n| JSON representation ||\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"url\": string, \"type\": enum(/search/apis/indexing-api/v3/reference/indexing/rest/v3/urlNotifications#UrlNotificationType), \"notifyTime\": string } ``` |\n\n| Fields ||\n|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `url` | `string` The object of this notification. The URL must be owned by the publisher of this notification and, in case of `URL_UPDATED` notifications, it *must* be crawlable by Google. |\n| `type` | `enum(`[UrlNotificationType](/search/apis/indexing-api/v3/reference/indexing/rest/v3/urlNotifications#UrlNotificationType)`)` The URL life cycle event that Google is being notified about. |\n| `notifyTime` | `string (`[Timestamp](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp)` format)` Creation timestamp for this notification. Users should *not* specify it, the field is ignored at the request time. A timestamp in RFC3339 UTC \"Zulu\" format, accurate to nanoseconds. Example: `\"2014-10-02T15:01:23.045123456Z\"`. \u003cbr /\u003e |\n\nUrlNotificationType\n-------------------\n\nSpecifies the different events that can happen to a given URL.\n\n| Enums ||\n|-------------------------------------|------------------------------------------------|\n| `URL_NOTIFICATION_TYPE_UNSPECIFIED` | Unspecified. |\n| `URL_UPDATED` | The given URL (Web document) has been updated. |\n| `URL_DELETED` | The given URL (Web document) has been deleted. |\n\n| Methods ------- ||\n|---------------------------------------------------------------------------------------------------------|--------------------------------------------------|\n| ### [getMetadata](/search/apis/indexing-api/v3/reference/indexing/rest/v3/urlNotifications/getMetadata) | Gets metadata about a Web Document. |\n| ### [publish](/search/apis/indexing-api/v3/reference/indexing/rest/v3/urlNotifications/publish) | Notifies that a URL has been updated or deleted. |"]]
