Medienelemente verwalten

Neben dem Zugriff auf Medien nachdem Sie sie hochgeladen haben, können Sie auch ihre Beschreibungen ändern.

Erforderlicher Autorisierungsbereich

Um die Beschreibungen von Medienelementen nach ihrer Erstellung zu ändern, verwende die photoslibrary.edit.appcreateddata Bereich.

Beschreibungen von Medienelementen ändern

Um die Beschreibung eines Medienelements zu ändern, erstelle einen media items update call durch die ID des Medienelements. Fügen Sie die neue Beschreibung in die

Damit du die Beschreibung eines Medienelements ändern kannst, müssen die Medien in deine App hochgeladen worden sein Artikel und der aktuell authentifizierte Nutzer muss der Eigentümer sein. Beschreibungen können nicht länger als 1.000 Zeichen sein.

REST

Hier ist ein PATCH-Anfrageheader zum Aktualisieren der Beschreibung eines Medienelements:

PATCH https://photoslibrary.googleapis.com/v1/mediaItems/media-item-id?updateMask=description

Diese Anfrage bestimmt, welche Eigenschaften aktualisiert werden, indem ein Feldmaske, die durch den Parameter updateMask in der URL angegeben wird.

Fügen Sie die neue Beschreibung in den Text der Anfrage ein:

{
  "description": "new-media-item-description"
}

Wenn der Vorgang erfolgreich ist, wird das aktualisierte Medienelement zurückgegeben:

{
  "id": "media-item-id",
  "description": "new-media-item-description",
  "productUrl": "media-item-product-url",
  "baseUrl": "media-items-in-album",
  "mimeType": "mime-type-of-media",
  "mediaMetadata": {
    ...
  },
  "contributorInfo": {
    ...
  },
  "fileName": "item-filename"
}

Java

try {
  // Update the description of the media item.
  // The new description must not be null.
  MediaItem updatedItem = photosLibraryClient.updateMediaItemDescription(mediaItem, "new-media-item-description");
} catch (ApiException e) {
  // Handle error
}

PHP

try {

    // ID of the media item to update.
    $mediaItemId = "MEDIA_ITEM_ID";

    // New description of the media item.
    $newDescription = "new-media-item-description";

    // Update the description of the media item identified.
    $mediaItem = $photosLibraryClient->updateMediaItemDescription($mediaItemId, $newDescription);

} catch (\Google\ApiCore\ApiException $e) {
    // Handle error
}