이 페이지는 Cloud Translation API를 통해 번역되었습니다.

맞춤 사용자 필드 관리

도메인에 맞춤 사용자 스키마를 추가하여 도메인의 사용자에 대한 맞춤 필드를 정의할 수 있습니다. 이 입력란을 사용하여 사용자가 작업하는 프로젝트, 실제 위치, 채용일 또는 비즈니스 요구사항에 맞는 기타 정보를 저장할 수 있습니다.

시작하려면 하나 이상의 스키마를 만들어 도메인에 적합한 맞춤 입력란을 정의합니다. 필드의 이름, 유형 (문자열, 불리언, 정수 등), 단일 값 또는 다중 값 여부, 값을 도메인의 모든 사용자가 볼 수 있는지 또는 관리자와 연결된 사용자만 볼 수 있는지와 같은 여러 속성을 지정할 수 있습니다.

스키마가 정의되면 맞춤 필드는 표준 필드와 동일하게 작동합니다. 도메인의 사용자를 업데이트할 때 설정하고, users.get 및 users.list를 사용하여 가져오고, 맞춤 입력란을 검색할 수 있습니다.

사용자 프로필에서 맞춤 입력란 설정

스키마를 업데이트하거나 만들려면 customSchemas속성을 만들고 사용자 리소스에 추가합니다. customSchemas 속성 내에서 맞춤 필드는 표준 JSON 형식의 스키마별로 그룹화됩니다.

"customSchemas": {
  "schema1": {
    "field1": "value1",
    "field2": [
      { "value": "value2a" },
      { "value": "value2b" },
      ...
    ],
    ...
  },
  "schema2": {
    "field3": "value3",
    ...
  },
  ...
}

단일 값 맞춤 입력란은 "field1": "value1"와 같은 간단한 키-값 쌍으로 설정됩니다. 다중 값 맞춤 입력란은 API의 표준 다중 값 필드(예: addresses 및 phones)와 같이 객체 배열로 설정됩니다. 이러한 값 객체는 다음 키를 지원합니다.

키
`value`	저장할 값입니다(필수).
`type`	값 유형입니다(선택사항). 가능한 값은 다음과 같습니다. `custom` `home` `other` `work`
`customType`	값의 맞춤 유형입니다(선택사항). `type`이 `custom`로 설정된 경우에 사용해야 합니다.

업데이트 시 스키마의 맞춤 필드가 지정되지 않으면 변경되지 않습니다. 업데이트 시 customFields에 스키마 자체가 지정되지 않은 경우 해당 스키마의 모든 맞춤 필드는 변경되지 않습니다. 프로필에서 맞춤 필드 또는 맞춤 스키마를 삭제하려면 이를 명시적으로 null로 설정해야 합니다.

"schema1": {
  "field1": null // deletes field1 from this profile.
}

JSON 요청

아래 예시의 호출은 사용자를 업데이트하고 employmentData 맞춤 스키마의 값을 설정합니다.

PATCH https://admin.googleapis.com/admin/directory/v1/users/[email protected]

{
  "customSchemas": {
    "employmentData": {
      "employeeNumber": "123456789",
      "jobFamily": "Engineering"
      "location": "Atlanta",
      "jobLevel": 8,
      "projects": [
        { "value": "GeneGnome" },
        { "value": "Panopticon", "type": "work" },
        { "value": "MegaGene", "type": "custom", "customType": "secret" }
      ]
    }
  }
}

사용자 프로필의 맞춤 입력란 읽기

users.get 또는 users.list 요청에서 projection 매개변수를 custom 또는 full로 설정하여 사용자 프로필의 맞춤 필드를 가져올 수 있습니다.

사용자 프로필에서 맞춤 입력란 검색

users.list 요청에서 query 매개변수를 사용하여 맞춤 입력란 내에서 검색할 수 있습니다. schemaName.fieldName 문법으로 맞춤 입력란을 요청합니다. 예를 들면 다음과 같습니다.

employmentData.projects:"GeneGnome"

GeneGnome 프로젝트에서 근무하는 모든 직원을 반환합니다. 쿼리

employmentData.location="Atlanta" employmentData.jobLevel>=7

직급 수준이 7보다 높은 애틀랜타의 모든 직원을 반환합니다. 자세한 내용은 사용자 검색을 참고하세요.

맞춤 사용자 스키마 만들기

맞춤 사용자 스키마는 모든 Google Workspace 계정의 도메인에 추가할 수 있습니다. 도메인에 맞춤 사용자 스키마를 만들려면 다음 POST 요청을 사용하고 요청 승인에 설명된 승인을 포함합니다. 요청 쿼리 문자열 속성은 API 참조를 참고하세요.

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer or customerId/schemas

모든 생성 요청에는 요청을 처리하는 데 필요한 정보를 제출해야 합니다. 클라이언트 라이브러리를 사용하는 경우 선택한 언어의 데이터 객체를 JSON 데이터 형식의 객체로 변환합니다.

JSON 요청

다음 샘플은 맞춤 스키마를 만들기 위한 요청을 보여줍니다. 요청 및 응답 속성의 전체 목록은 API 참조를 확인하세요.

{
  "schemaName": "employmentData",
  "fields": [
    {
      "fieldName": "EmployeeNumber",
      "fieldType": "STRING",
      "multiValued": "false"
    },
    {
      "fieldName": "JobFamily",
      "fieldType": "STRING",
      "multiValued": "false"
    }
  ]
}

응답이 성공하면 새 맞춤 스키마의 속성과 함께 HTTP 201 상태 코드가 반환됩니다.

맞춤 스키마 제한

계정에서 허용되는 맞춤 스키마의 최대 개수는 100개입니다.
계정에서 허용되는 맞춤 입력란의 최대 개수는 100개입니다.
단일 값 맞춤 입력란의 string 필드에 허용되는 최대 문자 수는 500자(영문 기준)입니다. 다중 값 맞춤 필드의 경우 허용되는 요소 수는 할당된 값의 크기에 따라 다릅니다. 예를 들어 값이 100자(영문 기준)인 값 150개 또는 값이 500자(영문 기준)인 값 50개를 추가할 수 있습니다.
맞춤 스키마 및 필드 이름에 허용되는 문자는 영숫자 문자, 밑줄 (_), 하이픈 (-)입니다.
필드 유형은 변경할 수 없습니다.
단일 값 필드는 다중 값으로 만들 수 있지만 역 연산은 허용되지 않습니다.
맞춤 스키마 또는 필드의 이름은 바꿀 수 없습니다.

맞춤 사용자 스키마 업데이트

맞춤 스키마를 업데이트하려면 다음 PUT 요청을 사용하고 요청 승인에 설명된 승인을 포함합니다. schemaKey는 스키마 이름 또는 고유한 스키마 id일 수 있습니다. 요청 및 응답 속성은 API 참조를 참고하세요.

PUT https://admin.googleapis.com/admin/directory/v1/customer/my_customer or customerId/schemas/schemaKey

JSON 요청

아래 예에서 스키마 employmentData는 처음 생성될 때 JobFamily 필드를 포함했습니다. 요청은 employmentData를 EmployeeNumber 필드만 포함하도록 업데이트합니다.

PUT https://admin.googleapis.com/admin/directory/v1/customer/my_customer/schemas/employmentData

{
  "kind": "admin#directory#schema",
  "schemaId": "dKaYmUwmSZy5lreXyh75hQ==",
  "etag": "\"St7vIdePbbDsQUvvrssynd-6JLg/PKg63GvWb7bnVSNRomd_O-Vi66w\"",
  "schemaName": "employmentData",
  "fields": [
    {
      "kind": "admin#directory#schema#fieldspec",
      "fieldId": "21_B4iQIRY-dIFGFgAX-Og==",
      "etag": "\"St7vIdePbbDsQUvvrssynd-6JLg/LZxiGaz6_N4R40OpKbDhOcy2qiE\"",
      "fieldType": "STRING",
      "fieldName": "EmployeeNumber",
      "multiValued": "false"
    }
  ]
}

모든 업데이트 요청에는 요청을 처리하는 데 필요한 정보를 제출해야 합니다.

응답이 성공하면 업데이트된 스키마 리소스와 함께 HTTP 200 상태 코드가 반환됩니다.

맞춤 사용자 스키마 검색

맞춤 스키마를 가져오려면 다음 GET 요청을 사용하고 요청 승인에 설명된 승인을 포함합니다. schemaKey는 스키마 이름 또는 고유한 스키마 id일 수 있습니다. 요청 및 응답 속성은 API 참조를 참고하세요.

GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer or customerId/schemas/schemaKey

응답이 성공하면 맞춤 스키마의 속성과 함께 HTTP 200 상태 코드가 반환됩니다.

{
  "kind": "admin#directory#schema",
  "schemaId": "dKaYmUwmSZy5lreXyh75hQ==",
  "etag": "\"KYnPjBPqr8knK6v7rpxly9BhNeY/PKg63GvWb7bnVSNRomd_O-Vi66w\"",
  "schemaName": "employmentData",
  "fields": [
    {
      "kind": "admin#directory#schema#fieldspec",
      "fieldId": "21_B4iQIRY-dIFGFgAX-Og==",
      "etag": "\"KYnPjBPqr8knK6v7rpxly9BhNeY/LZxiGaz6_N4R40OpKbDhOcy2qiE\"",
      "fieldType": "STRING",
      "fieldName": "EmployeeNumber"
    },
    {
      "kind": "admin#directory#schema#fieldspec",
      "fieldId": "ZKy0QtoMRy2QlM-4sAsPtQ==",
      "etag": "\"KYnPjBPqr8knK6v7rpxly9BhNeY/jEULI-ZiqywQIHXgc8evEcTE4Cc\"",
      "fieldType": "STRING",
      "fieldName": "JobFamily"
    }
  ]
}

모든 맞춤 사용자 스키마 검색

동일한 계정의 모든 맞춤 스키마를 가져오려면 다음 GET 요청을 사용하고 요청 승인에 설명된 승인을 포함합니다.요청 및 응답 속성은 API 참조를 참고하세요.

GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer or customerId/schemas

응답이 성공하면 계정의 맞춤 스키마와 함께 HTTP 200 상태 코드가 반환됩니다.

{
  "kind": "admin#directory#schemas",
  "etag": "\"KYnPjBPqr8knK6v7rpxly9BhNeY/iJ1eWn5AKuR-xTdwH_2IBlvSSKo\"",
  "schemas": [
    {
      "kind": "admin#directory#schema",
      "schemaId": "dKaYmUwmSZy5lreXyh75hQ==",
      "etag": "\"KYnPjBPqr8knK6v7rpxly9BhNeY/PKg63GvWb7bnVSNRomd_O-Vi66w\"",
      "schemaName": "employmentData",
      "fields": [
        {
          "kind": "admin#directory#schema#fieldspec",
          "fieldId": "21_B4iQIRY-dIFGFgAX-Og==",
          "etag": "\"KYnPjBPqr8knK6v7rpxly9BhNeY/LZxiGaz6_N4R40OpKbDhOcy2qiE\"",
          "fieldType": "STRING",
          "fieldName": "EmployeeNumber"
        },
        {
          "kind": "admin#directory#schema#fieldspec",
          "fieldId": "ZKy0QtoMRy2QlM-4sAsPtQ==",
          "etag": "\"KYnPjBPqr8knK6v7rpxly9BhNeY/jEULI-ZiqywQIHXgc8evEcTE4Cc\"",
          "fieldType": "STRING",
          "fieldName": "JobFamily"
        }
      ]
    }
  ]
}