Method: mediaItems.batchGet

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

คำขอ HTTP

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

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

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

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

string

ต้องระบุ ตัวระบุของรายการสื่อที่จะขอ ต้องไม่มีตัวระบุซ้ำและต้องไม่ว่างเปล่า จำนวนรายการสื่อสูงสุดที่สามารถดึงข้อมูลได้ในการเรียก 1 ครั้งคือ 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

MediaItemResult

ผลของการเรียกรายการสื่อ

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

object (Status)

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

object (MediaItem)

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