Method: spaces.messagePins.list

แสดงรายการข้อความที่ปักหมุดในพื้นที่ทำงาน ผู้ใช้สามารถปักหมุดข้อความสำคัญในพื้นที่ทำงานเพื่อให้เข้าถึงได้ง่าย ดูข้อมูลเพิ่มเติมได้ที่ปักหมุดหรือเลิกปักหมุดการสนทนาใน Google Chat

ต้องใช้การตรวจสอบสิทธิ์ผู้ใช้ที่มีขอบเขตการให้สิทธิ์อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/chat.spaces.pins.readonly
  • https://www.googleapis.com/auth/chat.spaces.pins
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.spaces

คำขอ HTTP

GET https://chat.googleapis.com/v1/{parent=spaces/*}/messagePins

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

พารามิเตอร์เส้นทาง

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

string

ต้องระบุ พื้นที่หลักที่เป็นเจ้าของคอลเล็กชันของรายการที่ปักหมุด รูปแบบ: spaces/{space}

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

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

integer

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

string

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

เมื่อแบ่งหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุควรตรงกับการเรียกที่ให้โทเค็นหน้าเว็บ การส่งค่าที่แตกต่างกันไปยังพารามิเตอร์อื่นๆ อาจทําให้เกิดผลลัพธ์ที่ไม่คาดคิด

เนื้อความของคำขอ

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

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

ข้อความตอบกลับสำหรับการปักหมุดข้อความในรายการ

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

การแสดง JSON 
{
  "messagePins": [
    {
      object (MessagePin)
    }
  ],
  "nextPageToken": string
}
ช่อง
messagePins[]

object (MessagePin)

ข้อความที่ปักหมุดจากพื้นที่ทำงานที่ระบุ
nextPageToken

string

คุณส่งโทเค็นเป็น pageToken เพื่อดึงข้อมูลผลลัพธ์หน้าถัดไปได้ หากว่างเปล่า แสดงว่าไม่มีหน้าถัดไป

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

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/chat.spaces.pins
  • https://www.googleapis.com/auth/chat.spaces.pins.readonly
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly

ดูข้อมูลเพิ่มเติมได้ที่คู่มือการให้สิทธิ์