Zarządzanie elementami multimedialnymi

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
}