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 }