Oprócz accessing do elementów multimedialnych po ich przesłaniu możesz też zmienić ich opisy.
Wymagany zakres autoryzacji
Aby zmienić opisy elementów multimedialnych po ich utworzeniu, użyj zakresu photoslibrary.edit.appcreateddata
.
Zmiana opisów elementów multimedialnych
Aby zmienić opis elementu multimedialnego, utwórz parametr media items update call
z jego identyfikatorem i dodaj do żądania nowy opis.
Aby można było zmienić opis elementu multimedialnego, aplikacja musi go przesłać, a obecnie uwierzytelniony użytkownik musi być właścicielem tego elementu. Opisy nie mogą mieć więcej niż 1000 znaków.
REST
Oto nagłówek żądania PATCH, który pozwala zaktualizować opis elementu multimedialnego:
PATCH https://photoslibrary.googleapis.com/v1/mediaItems/media-item-id?updateMask=description
To żądanie określa, które właściwości są aktualizowane przez uwzględnienie w adresie URL maski pola wskazywanej przez parametr updateMask
.
Umieść nowy opis w treści żądania:
{ "description": "new-media-item-description" }
Jeśli operacja się uda, w odpowiedzi zostanie zwrócony zaktualizowany element multimedialny:
{ "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 }