Method: mediaItems.batchGet

แสดงรายการรายการสื่อสำหรับตัวระบุรายการสื่อที่ระบุ ระบบจะแสดงรายการตามลำดับเดียวกับตัวระบุที่ระบุ

คำขอ HTTP

GET https://photoslibrary.googleapis.com/v1/mediaItems:batchGet

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์การค้นหา

พารามิเตอร์
mediaItemIds[]

string

ต้องระบุ ตัวระบุของรายการสื่อที่จะขอ ต้องไม่มีตัวระบุซ้ำและต้องไม่ว่างเปล่า จำนวนรายการสื่อสูงสุดที่สามารถเรียกข้อมูลได้ในครั้งเดียวคือ 50 รายการ

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

การตอบสนองเพื่อดึงข้อมูลรายการสื่อ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "mediaItemResults": [
    {
      object (MediaItemResult)
    }
  ]
}
ช่อง
mediaItemResults[]

object (MediaItemResult)

เอาต์พุตเท่านั้น รายการรายการสื่อที่ดึงข้อมูล โปรดทราบว่าแม้การเรียกใช้ mediaItems.batchGet จะสำเร็จ แต่รายการสื่อบางรายการในชุดอาจไม่สำเร็จ ระบบจะระบุการไม่ผ่านการตรวจสอบเหล่านี้ใน MediaItemResult.status แต่ละรายการ

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.readonly
  • https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata
  • https://www.googleapis.com/auth/photoslibrary.readonly.originals

MediaItemResult

ผลการเรียกข้อมูลรายการสื่อ

การแสดง JSON 
{
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
ช่อง
status

object (Status)

หากเกิดข้อผิดพลาดขณะเข้าถึงรายการสื่อนี้ ระบบจะป้อนข้อมูลที่เกี่ยวข้องกับข้อผิดพลาดในช่องนี้ ดูรายละเอียดเกี่ยวกับช่องนี้ได้ที่ Status
mediaItem

object (MediaItem)

รายการสื่อที่ดึงมาจากคลังภาพของผู้ใช้ ระบบจะป้อนข้อมูลหากไม่เกิดข้อผิดพลาดและดึงข้อมูลรายการสื่อสําเร็จ