Method: sessions.create

สร้างเซสชันใหม่ในระหว่างที่ผู้ใช้สามารถเลือกรูปภาพและวิดีโอเพื่อให้บุคคลที่สามเข้าถึงได้

หากผู้ใช้ไม่มีบัญชี Google Photos ที่ใช้งานอยู่ ระบบจะแสดงข้อผิดพลาด FAILED_PRECONDITION

หากแอปพลิเคชันไคลเอ็นต์สร้างเซสชันต่อผู้ใช้มากเกินไป ระบบจะแสดงข้อผิดพลาด RESOURCE_EXHAUSTED ลูกค้ามีแนวโน้มที่จะไม่ใช้ถึงขีดจํากัดเหล่านี้ภายใต้สถานการณ์ปกติ อย่างไรก็ตาม เรายังคงแนะนำให้ลูกค้าเรียกใช้ sessions.delete หลังจากเซสชันแต่ละครั้งเพื่อให้ใช้ทรัพยากรไม่เกินขีดจำกัด

เมื่อผู้ใช้แตะปุ่มเสร็จสิ้นเพื่อสิ้นสุดเซสชันการเลือก pickerUri จะไม่ทำงานอีกต่อไป สร้างเซสชันใหม่เพื่อให้ผู้ใช้เลือกรูปภาพเพิ่มได้

คำขอ HTTP

POST https://photospicker.googleapis.com/v1/sessions

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

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

พารามิเตอร์
requestId

string

ไม่บังคับ ตัวระบุที่ไม่ซ้ำกันซึ่งไคลเอ็นต์ระบุสำหรับคำขอนี้

รหัสนี้ใช้เพื่อเปิดใช้ประสบการณ์การเลือกที่มีประสิทธิภาพยิ่งขึ้นสำหรับแอปพลิเคชันที่ใช้ขั้นตอน OAuth 2.0 สำหรับอุปกรณ์ที่มีอินพุตแบบจำกัด

รหัสนี้ต้องอยู่ในรูปแบบสตริง UUID (เวอร์ชัน 4) และเป็นไปตามข้อกําหนดต่อไปนี้

  • ต้องไม่มีข้อมูลที่ละเอียดอ่อนซึ่งระบุตัวตนเกี่ยวกับผู้ใช้
  • ประกอบด้วยอักขระฐาน 16 32 ตัวที่แบ่งออกเป็น 5 กลุ่มและคั่นด้วยเครื่องหมายขีดกลางในรูปแบบ "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" (หรือ 8-4-4-4-12)

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

เนื้อความของคำขอมีอินสแตนซ์ของ PickingSession

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

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ PickingSession ที่สร้างขึ้นใหม่

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

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

  • https://www.googleapis.com/auth/photospicker.mediaitems.readonly