Medya öğelerine yükledikten sonra accessing yanı sıra açıklamalarını da değiştirebilirsiniz.
Gerekli yetkilendirme kapsamı
Medya öğeleri oluşturulduktan sonra açıklamalarını değiştirmek için photoslibrary.edit.appcreateddata
kapsamını kullanın.
Medya öğesi açıklamalarını değiştirme
Bir medya öğesinin açıklamasını değiştirmek için medya öğesinin tanımlayıcısıyla media items update call
yapın ve yeni açıklamayı isteğe ekleyin.
Bir medya öğesinin açıklamasını değiştirmek için uygulamanızın medya öğesini yüklemiş olması ve kimliği doğrulanmış kullanıcının sahip olması gerekir. Açıklamalar en fazla 1.000 karakter uzunluğunda olabilir.
REST
Burada, bir medya öğesi açıklamasını güncellemek için YAMA isteği başlığını görebilirsiniz:
PATCH https://photoslibrary.googleapis.com/v1/mediaItems/media-item-id?updateMask=description
Bu istek, URL'deki updateMask
parametresiyle belirtilen bir alan maskesi ekleyerek hangi özelliklerin güncellendiğini belirler.
Yeni açıklamayı isteğin gövdesine ekleyin:
{ "description": "new-media-item-description" }
Başarılı olursa yanıt, güncellenmiş medya öğesini döndürür:
{ "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 }