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

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

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

การเปลี่ยนคําอธิบายเนื้อหาที่สร้างในแอปต้องใช้ขอบเขต 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"
}