The Data Manager API is in closed beta. To express interest in joining the closed beta, fill out
this form.
UserData
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
사용자를 식별하는 데이터입니다. 식별자가 하나 이상 필요합니다.
필드 |
userIdentifiers[] |
object (UserIdentifier )
필수 항목입니다. 사용자의 식별자입니다. 동일한 유형의 데이터 (예: 여러 이메일 주소)를 여러 개 제공할 수 있습니다. 일치 가능성을 높이려면 식별자를 최대한 많이 제공하세요. AudienceMember 또는 Event 하나에 최대 10개의 userIdentifiers 을 제공할 수 있습니다.
|
UserIdentifier
JSON 표현 |
{
// Union field identifier can be only one of the following:
"emailAddress": string,
"phoneNumber": string,
"address": {
object (AddressInfo )
}
// End of list of possible types for union field identifier .
} |
필드 |
통합 필드 identifier . 정확히 하나를 지정해야 합니다. identifier 은 다음 중 하나여야 합니다. |
emailAddress |
string
정규화 후 SHA-256 해시 함수를 사용하여 해싱된 이메일 주소입니다.
|
phoneNumber |
string
정규화 (E164 표준) 후 SHA-256 해시 함수를 사용하여 해싱된 전화번호입니다.
|
address |
object (AddressInfo )
사용자 주소의 알려진 구성요소입니다. 한 번에 모두 일치하는 식별자의 그룹화를 보유합니다.
|
AddressInfo
JSON 표현 |
{
"givenName": string,
"familyName": string,
"regionCode": string,
"postalCode": string
} |
필드 |
givenName |
string
필수 항목입니다. 사용자의 이름 (성 제외)입니다. 모두 소문자이며, 구두점이나 앞뒤 공백이 없고 SHA-256으로 해싱됩니다.
|
familyName |
string
필수 항목입니다. 사용자의 성입니다. 모두 소문자이며, 구두점과 앞뒤 공백이 없고 SHA-256으로 해싱됩니다.
|
regionCode |
string
필수 항목입니다. 사용자 주소의 ISO-3166-1 alpha-2에 따른 2글자 지역 코드입니다.
|
postalCode |
string
필수 항목입니다. 사용자 주소의 우편번호입니다.
|
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[],[],null,["# UserData\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [UserIdentifier](#UserIdentifier)\n - [JSON representation](#UserIdentifier.SCHEMA_REPRESENTATION)\n- [AddressInfo](#AddressInfo)\n - [JSON representation](#AddressInfo.SCHEMA_REPRESENTATION)\n\nData that identifies the user. At least one identifier is required.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------|\n| ``` { \"userIdentifiers\": [ { object (/data-manager/api/reference/rest/v1/UserData#UserIdentifier) } ] } ``` |\n\n| Fields ||\n|---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `userIdentifiers[]` | `object (`[UserIdentifier](/data-manager/api/reference/rest/v1/UserData#UserIdentifier)`)` Required. The identifiers for the user. It's possible to provide multiple instances of the same type of data (for example, multiple email addresses). To increase the likelihood of a match, provide as many identifiers as possible. At most 10 `userIdentifiers` can be provided in a single [AudienceMember](/data-manager/api/reference/rest/v1/AudienceMember) or [Event](/data-manager/api/reference/rest/v1/events/ingest#Event). |\n\nUserIdentifier\n--------------\n\nA single identifier for the user.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { // Union field `identifier` can be only one of the following: \"emailAddress\": string, \"phoneNumber\": string, \"address\": { object (/data-manager/api/reference/rest/v1/UserData#AddressInfo) } // End of list of possible types for union field `identifier`. } ``` |\n\n| Fields ||\n|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Union field `identifier`. Exactly one must be specified. `identifier` can be only one of the following: ||\n| `emailAddress` | `string` Hashed email address using SHA-256 hash function after normalization. |\n| `phoneNumber` | `string` Hashed phone number using SHA-256 hash function after normalization (E164 standard). |\n| `address` | `object (`[AddressInfo](/data-manager/api/reference/rest/v1/UserData#AddressInfo)`)` The known components of a user's address. Holds a grouping of identifiers that are matched all at once. |\n\nAddressInfo\n-----------\n\nAddress information for the user.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------|\n| ``` { \"givenName\": string, \"familyName\": string, \"regionCode\": string, \"postalCode\": string } ``` |\n\n| Fields ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------|\n| `givenName` | `string` Required. Given (first) name of the user, all lowercase, with no punctuation, no leading or trailing whitespace, and hashed as SHA-256. |\n| `familyName` | `string` Required. Family (last) name of the user, all lowercase, with no punctuation, no leading or trailing whitespace, and hashed as SHA-256. |\n| `regionCode` | `string` Required. The 2-letter region code in ISO-3166-1 alpha-2 of the user's address. |\n| `postalCode` | `string` Required. The postal code of the user's address. |"]]