Method: mediaItems.get

  • This method retrieves a specific media item using its unique identifier (mediaItemId).

  • The request must be authorized using one of the specified OAuth scopes, granting access to the user's photo library.

  • Functionality will be limited to media items created by your app starting March 31, 2025, as some authorization scopes are being changed (see Photos APIs updates for details).

  • The response provides a detailed representation of the requested media item, including its properties and metadata.

  • No request body is required; simply provide the mediaItemId as a path parameter in the GET request URL.

Returns the app created media item for the specified media item identifier.

HTTP request

GET https://photoslibrary.googleapis.com/v1/mediaItems/{mediaItemId}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
mediaItemId

string

Required. Identifier of the media item to be requested.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of MediaItem.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata