Method: mediaItems.batchGet

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

คำขอ HTTP

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

URL ใช้ไวยากรณ์ gRPC Transcoding

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

พารามิเตอร์
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

ผลลัพธ์ของ MediaItem

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

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

object (Status)

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

object (MediaItem)

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