Person Group Operations - Get Person Group Persons

등록된 사람 얼굴의 personId, name, userData 및 persistedFaceIds를 포함하여 지정된 사람 그룹에 있는 모든 사람의 정보를 나열합니다.
개인은 "사람 그룹 사람 만들기"에서 만든 personId의 사전순으로 저장됩니다.

• • "start" 매개 변수(문자열, 선택 사항)는 반환된 항목이 문자열 비교에 따라 더 큰 ID를 가질 ID 값을 지정합니다. "start"를 빈 값으로 설정하면 첫 번째 항목부터 항목을 반환해야 합니다.
  • "top" 매개 변수(int, 선택 사항)는 반환할 최대 항목 수를 결정하며 호출당 최대 1,000개의 항목으로 제한됩니다. 이 제한을 초과하는 추가 항목을 검색하려면 현재 호출에서 반환된 마지막 항목의 personId로 "시작"을 지정합니다.

GET {endpoint}/face/{apiVersion}/persongroups/{personGroupId}/persons

GET {endpoint}/face/{apiVersion}/persongroups/{personGroupId}/persons?start={start}&top={top}

URI 매개 변수

응답

보안

Ocp-Apim-Subscription-Key

Azure AI Face 구독의 비밀 키입니다.

형식: apiKey
In(다음 안에): header

AADToken

Azure Active Directory OAuth2 흐름

형식: oauth2
Flow: accessCode
권한 부여 URL: https://api.example.com/oauth2/authorize
토큰 URL: https://api.example.com/oauth2/token

범위

예제

Get Persons from PersonGroup

GET {endpoint}/face/v1.2-preview.1/persongroups/your_person_group_id/persons?start=00000000-0000-0000-0000-000000000000&top=20

[
  {
    "personId": "25985303-c537-4467-b41d-bdb45cd95ca1",
    "name": "your_person_group_person_name",
    "userData": "your_user_data",
    "persistedFaceIds": [
      "43897a75-8d6f-42cf-885e-74832febb055"
    ]
  }
]

정의

FaceError

오류 개체입니다. Face Service에서 반환된 오류 코드 및 메시지에 대한 포괄적인 세부 정보는 다음 링크를 참조하세요. https://aka.ms/face-error-codes-and-messages.

FaceErrorResponse

오류 세부 정보가 포함된 응답입니다.

PersonGroupPerson

지정된 사용자 그룹의 사용자입니다. 이 사람에게 얼굴을 추가하려면 "큰 사람 그룹 사람 얼굴 추가"를 호출하세요.