Method: accounts.invitations.list

แสดงคำเชิญที่รอดำเนินการสำหรับบัญชีที่ระบุ

คำขอ HTTP

GET https://mybusinessaccountmanagement.googleapis.com/v1/{parent=accounts/*}/invitations

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

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

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

string

ต้องระบุ ชื่อบัญชีที่มีการเรียกข้อมูลรายการคำเชิญ accounts/{account_id}/invitations

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

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

string

ไม่บังคับ ระบบรองรับการกรองการตอบกลับผ่านช่อง Invitation.target_type

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

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

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

ข้อความตอบกลับสำหรับ AccessControl.ListInvites

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

การแสดง JSON
{
  "invitations": [
    {
      object (Invitation)
    }
  ]
}
ช่อง
invitations[]

object (Invitation)

คอลเล็กชันของคำเชิญที่รอดำเนินการสำหรับบัญชี จำนวนคำเชิญที่แสดงที่นี่ต้องไม่เกิน 1,000 รายการ

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

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

  • https://www.googleapis.com/auth/business.manage

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0

คำเชิญ

แสดงคำเชิญที่รอดำเนินการ

การแสดง JSON
{
  "name": string,
  "role": enum (AdminRole),
  "targetType": enum (TargetType),

  // Union field target can be only one of the following:
  "targetAccount": {
    object (Account)
  },
  "targetLocation": {
    object (TargetLocation)
  }
  // End of list of possible types for union field target.
}
ช่อง
name

string

ต้องระบุ ชื่อทรัพยากรสำหรับคำเชิญ accounts/{account_id}/invitations/{invitation_id}.

role

enum (AdminRole)

เอาต์พุตเท่านั้น บทบาทที่ได้รับเชิญในบัญชี

targetType

enum (TargetType)

เอาต์พุตเท่านั้น ระบุประเภทเป้าหมายที่ควรปรากฏในการตอบกลับ

ฟิลด์การรวม target ระบุว่าคำเชิญนี้เป็นใครเพื่อเป้าหมาย target ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
targetAccount

object (Account)

บัญชีที่มีการป้อนข้อมูลบางส่วนสำหรับคำเชิญนี้

targetLocation

object (TargetLocation)

สถานที่เป้าหมายที่คำเชิญนี้ใช้

TargetLocation

แสดงสถานที่เป้าหมายสำหรับคำเชิญที่รอดำเนินการ

การแสดง JSON
{
  "locationName": string,
  "address": string
}
ช่อง
locationName

string

ชื่อของสถานที่ที่ผู้ใช้ได้รับเชิญ

address

string

ที่อยู่ของสถานที่ตั้งที่เชิญผู้ใช้ไป

TargetType

ประเภทของเป้าหมายที่คำเชิญมีไว้สำหรับ

Enum
TARGET_TYPE_UNSPECIFIED ตั้งค่าเมื่อไม่ได้ระบุประเภทเป้าหมาย
ACCOUNTS_ONLY แสดงคำเชิญสำหรับเป้าหมายประเภทบัญชีเท่านั้น
LOCATIONS_ONLY แสดงรายการคำเชิญสำหรับเป้าหมายประเภทสถานที่เท่านั้น