Method: accountTypes.accounts.userListGlobalLicenses.userListGlobalLicenseCustomerInfos.list

사용자 목록 전역 라이선스의 모든 고객 정보를 나열합니다.

이 기능은 데이터 파트너만 사용할 수 있습니다.

HTTP 요청

GET https://datamanager.googleapis.com/v1/{parent=accountTypes/*/accounts/*/userListGlobalLicenses/*}/userListGlobalLicenseCustomerInfos

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
parent

string

필수 항목입니다. 고객 정보를 쿼리하는 글로벌 라이선스입니다. accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}/userListGlobalLicenses/{USER_LIST_GLOBAL_LICENSE_ID} 형식이어야 합니다. 계정의 모든 전역 라이선스 고객 정보를 나열하려면 사용자 목록 전역 라이선스 ID를 '-'로 바꿉니다(예: accountTypes/DATA_PARTNER/accounts/123/userListGlobalLicenses/-).

쿼리 매개변수

파라미터
filter

string

선택사항입니다. 목록 요청에 적용할 필터 문자열입니다. 모든 필드는 각 조건의 왼쪽에 있어야 합니다 (예: user_list_id = 123). 필드는 모두 카멜 케이스 또는 모두 스네이크 케이스를 사용하여 지정해야 합니다. 카멜 케이스와 스네이크 케이스를 함께 사용하지 마세요.

지원되는 작업:

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=

지원되지 않는 필드:

  • name (대신 get 메서드 사용)
  • historical_pricings 및 모든 하위 필드
  • pricing.start_time
  • pricing.end_time
pageSize

integer

선택사항입니다. 반환할 라이선스의 최대 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50개의 라이선스가 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다.
pageToken

string

선택사항입니다. 이전 ListUserListDirectLicense 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ListUserListDirectLicense에 제공된 다른 모든 매개 변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

[ListUserListGlobalLicensesCustomerInfoRequest][google.ads.datamanager.v1.ListUserListGlobalLicensesCustomerInfoRequest]의 응답입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "userListGlobalLicenseCustomerInfos": [
    {
      object (UserListGlobalLicenseCustomerInfo)
    }
  ],
  "nextPageToken": string
}
필드
userListGlobalLicenseCustomerInfos[]

object (UserListGlobalLicenseCustomerInfo)

요청에 있는 지정된 라이선스의 고객 정보입니다.
nextPageToken

string

다음 페이지를 검색하기 위해 pageToken으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/datamanager

UserListGlobalLicenseCustomerInfo

사용자 목록 전역 라이선스의 고객에 관한 정보입니다. 고객이 전 세계 라이선스를 구매하면 시스템에서 자동으로 생성됩니다.

JSON 표현 
{
  "name": string,
  "userListId": string,
  "userListDisplayName": string,
  "licenseType": enum (UserListGlobalLicenseType),
  "status": enum (UserListLicenseStatus),
  "pricing": {
    object (UserListLicensePricing)
  },
  "clientAccountType": enum (UserListLicenseClientAccountType),
  "clientAccountId": string,
  "clientAccountDisplayName": string,
  "historicalPricings": [
    {
      object (UserListLicensePricing)
    }
  ],
  "metrics": {
    object (UserListLicenseMetrics)
  }
}
필드
name

string

식별자. 사용자 목록 전역 라이선스 고객의 리소스 이름입니다.
userListId

string (int64 format)

출력 전용입니다. 라이선스가 부여된 사용자 목록의 ID입니다.
userListDisplayName

string

출력 전용입니다. 라이선스가 부여된 사용자 목록의 이름입니다.
licenseType

enum (UserListGlobalLicenseType)

출력 전용입니다. 사용자 목록에 라이선스가 부여된 클라이언트 고객의 제품 유형입니다.
status

enum (UserListLicenseStatus)

출력 전용입니다. UserListDirectLicense의 상태입니다(ENABLED 또는 DISABLED).
pricing

object (UserListLicensePricing)

출력 전용입니다. UserListDirectLicense 가격 책정입니다.
clientAccountType

enum (UserListLicenseClientAccountType)

출력 전용입니다. 사용자 목록에 라이선스가 부여된 클라이언트 고객의 제품 유형입니다.
clientAccountId

string (int64 format)

출력 전용입니다. 사용자 목록에 라이선스가 부여된 클라이언트 고객의 ID입니다.
clientAccountDisplayName

string

출력 전용입니다. 사용자 목록에 라이선스가 부여된 클라이언트 고객의 이름입니다.
historicalPricings[]

object (UserListLicensePricing)

출력 전용입니다. 이 사용자 목록 라이선스의 가격 책정 기록입니다.
metrics

object (UserListLicenseMetrics)

출력 전용입니다. 이 라이선스와 관련된 측정항목

이 필드는 start 및 end 날짜가 userListGlobalLicenseCustomerInfos.list 호출에서 설정된 경우에만 채워집니다.