จัดการรายการสื่อ

นอกเหนือจากการเข้าถึงสื่อ หลังจากอัปโหลดแล้ว คุณจะทำสิ่งต่อไปนี้ได้ เปลี่ยนคำอธิบายได้อีกด้วย

ขอบเขตการให้สิทธิ์ที่จำเป็น

หากต้องการเปลี่ยนคำอธิบายรายการสื่อหลังจากการสร้าง ให้ใช้ photoslibrary.edit.appcreateddata ขอบเขต

การเปลี่ยนคำอธิบายรายการสื่อ

หากต้องการเปลี่ยนคำอธิบายของรายการสื่อ ให้สร้าง media items update call ด้วยตัวระบุของรายการสื่อ และใส่คำอธิบายใหม่ใน อีกครั้ง

หากต้องการเปลี่ยนคำอธิบายของรายการสื่อ แอปของคุณต้องอัปโหลดสื่อก่อน และผู้ใช้ที่ตรวจสอบสิทธิ์แล้วในปัจจุบันจะต้องเป็นเจ้าของ คำอธิบายสามารถ ต้องมีความยาวไม่เกิน 1,000 อักขระ

REST

ต่อไปนี้เป็นส่วนหัวของคำขอ Patch เพื่ออัปเดตคำอธิบายรายการสื่อ

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

คำขอนี้จะระบุว่ากำลังอัปเดตพร็อพเพอร์ตี้ใดอยู่โดยใส่ ฟิลด์มาสก์ ซึ่งระบุโดยพารามิเตอร์ updateMask ใน URL

ใส่คำอธิบายใหม่ไว้ในเนื้อหาของคำขอ ดังนี้

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

หากสำเร็จ การตอบกลับจะแสดงรายการสื่อที่อัปเดตแล้ว:

{
  "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
}