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

MediaItemResult

ผลของการดึงข้อมูลรายการสื่อ

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

object (Status)

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

object (MediaItem)

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