Medienelemente verwalten

Sie können nicht nur auf Medienelemente accessing, sondern auch deren Beschreibungen ändern.

Erforderlicher Autorisierungsbereich

Wenn Sie die Beschreibungen von Medienelementen nach ihrer Erstellung ändern möchten, verwenden Sie den Bereich photoslibrary.edit.appcreateddata.

Beschreibungen von Medienelementen ändern

Wenn Sie die Beschreibung eines Medienelements ändern möchten, erstellen Sie einen media items update call mit der ID des Medienelements und fügen Sie die neue Beschreibung in die Anfrage ein.

Zum Ändern der Beschreibung eines Medienelements muss Ihre App das Medienelement hochgeladen haben und der aktuell authentifizierte Nutzer muss der Eigentümer sein. Beschreibungen dürfen maximal 1.000 Zeichen lang 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 Attribute aktualisiert werden. Dazu wird eine Feldmaske eingefügt, 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 war, wird in der Antwort 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
}