Method: urlNotifications.publish

  • The Indexing API's urlNotifications.publish endpoint allows you to notify Google about URL updates or deletions.

  • Requests are sent as HTTP POST to https://indexing.googleapis.com/v3/urlNotifications:publish with a request body containing a UrlNotification object.

  • Successful responses provide metadata about the notification events received for the URL in the form of a UrlNotificationMetadata object.

  • Authorization requires the https://www.googleapis.com/auth/indexing OAuth scope.

Notifies that a URL has been updated or deleted.

HTTP request

POST https://indexing.googleapis.com/v3/urlNotifications:publish

The URL uses Google API HTTP annotation syntax.

Request body

The request body contains an instance of UrlNotification.

Response body

If successful, the response body contains data with the following structure:

Output for urlNotifications.publish

JSON representation
{
  "urlNotificationMetadata": {
    object(UrlNotificationMetadata)
  }
}
Fields
urlNotificationMetadata

object(UrlNotificationMetadata)

Description of the notification events received for this URL.

Authorization Scopes

Requires the following OAuth scope:

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

Try it!