นอกจากaccessingรายการสื่อหลังจากที่คุณอัปโหลดรายการเหล่านั้นแล้ว คุณยังเปลี่ยนคำอธิบายของเหล่านั้นได้
ขอบเขตการให้สิทธิ์ที่จำเป็น
หากต้องการเปลี่ยนคำอธิบายของรายการสื่อหลังจากการสร้าง ให้ใช้ขอบเขต photoslibrary.edit.appcreateddata
การเปลี่ยนคำอธิบายรายการสื่อ
หากต้องการเปลี่ยนคำอธิบายของรายการสื่อ ให้สร้าง media items update call
พร้อมตัวระบุของรายการสื่อ และใส่คำอธิบายใหม่ในคำขอ
หากต้องการเปลี่ยนคำอธิบายของรายการสื่อ แอปของคุณต้องอัปโหลดรายการสื่อไว้แล้ว และผู้ใช้ที่ตรวจสอบสิทธิ์แล้วในปัจจุบันต้องเป็นเจ้าของ คำอธิบายต้องมีความยาวไม่เกิน 1,000 อักขระ
REST
ต่อไปนี้เป็นส่วนหัวของคำขอแพตช์เพื่ออัปเดตคำอธิบายรายการสื่อ
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 }