Method: customEmojis.list

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

อีโมจิที่กำหนดเองจะใช้ได้กับบัญชี Google Workspace เท่านั้น และผู้ดูแลระบบต้องเปิดใช้อีโมจิที่กำหนดเองให้กับองค์กร ดูข้อมูลเพิ่มเติมได้ที่ดูข้อมูลเกี่ยวกับอีโมจิที่กำหนดเองใน Google Chat และจัดการสิทธิ์การใช้อีโมจิที่กำหนดเอง

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

  • https://www.googleapis.com/auth/chat.customemojis.readonly
  • https://www.googleapis.com/auth/chat.customemojis

คำขอ HTTP

GET https://chat.googleapis.com/v1/customEmojis

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

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

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

integer

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

string

ไม่บังคับ (หากกลับมาดำเนินการต่อจากการค้นหาก่อนหน้า)

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

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

string

ไม่บังคับ ตัวกรองข้อความค้นหา

รองรับการกรองตามครีเอเตอร์

หากต้องการกรองตามครีเอเตอร์ คุณต้องระบุค่าที่ถูกต้อง ปัจจุบันระบบยอมรับเฉพาะ creator("users/me") และ NOT creator("users/me") เพื่อกรองอีโมจิที่กำหนดเองตามว่าผู้ใช้ที่โทรเป็นคนสร้างหรือไม่

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

creator("users/me")

ระบบจะปฏิเสธการค้นหาที่ไม่ถูกต้องด้วยข้อผิดพลาด INVALID_ARGUMENT

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

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

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

การตอบสนองต่อรายการอีโมจิที่กำหนดเอง

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

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

object (CustomEmoji)

รายการที่ไม่เรียงลําดับ รายการอีโมจิที่กำหนดเอง
nextPageToken

string

โทเค็นที่คุณส่งเป็น pageToken เพื่อเรียกข้อมูลหน้าถัดไปของผลการค้นหาได้ หากเป็นค่าว่าง จะไม่มีหน้าถัดไป

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

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

  • https://www.googleapis.com/auth/chat.customemojis
  • https://www.googleapis.com/auth/chat.customemojis.readonly

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