Medya öğelerini yönet

Yüklediğiniz medya öğelerine erişebilir ve bu öğeleri alabilir, ayrıca açıklamalarını da değiştirebilirsiniz.

Gerekli yetkilendirme kapsamı

Uygulama tarafından oluşturulan içerikle ilgili açıklamaları değiştirmek için photoslibrary.edit.appcreateddata kapsamı gerekir. Kapsamlar hakkında daha fazla bilgi için Yetkilendirme kapsamları başlıklı makaleyi inceleyin.

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ını içeren bir media items update call oluşturun 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ış geçerli kullanıcının medya öğesinin sahibi olması gerekir. Açıklamalar en fazla 1.000 karakter uzunluğunda olabilir.

REST

Bir medya öğesi açıklamasını güncellemek için PATCH istek başlığı:

PATCH https://photoslibrary.googleapis.com/v1/mediaItems/media-item-id?updateMask=description

Bu istek, URL'deki updateMask parametresi ile belirtilen bir alan maskesi ekleyerek hangi özelliklerin güncelleneceğini belirler.

Yeni açıklamayı isteğin gövdesine ekleyin:

{
  "description": "new-media-item-description"
}

İşlem başarılı olursa yanıtta güncellenen medya öğesi döndürülü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"
}