Method: properties.list

지정된 상위 계정 아래의 하위 속성을 반환합니다.

'GA4' 속성만 반환됩니다. 호출자에게 액세스 권한이 없으면 속성이 제외됩니다. 소프트 삭제된 속성 (즉, '휴지통')은 기본적으로 제외됩니다. 관련 속성이 없으면 빈 목록을 반환합니다.

HTTP 요청

GET https://analyticsadmin.googleapis.com/v1beta/properties

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

쿼리 매개변수

매개변수
filter

string

필수 항목입니다. 요청 결과를 필터링하기 위한 표현식입니다. 필터링할 수 있는 필드는 parent:(상위 계정/속성의 리소스 이름) 또는 ancestor:(상위 계정의 리소스 이름) 또는 firebase_project:(연결된 Firebase 프로젝트의 ID 또는 번호)입니다. 필터의 예는 다음과 같습니다.

| Filter                      | Description                               |
|-----------------------------|-------------------------------------------|
| parent:accounts/123         | The account with account id: 123.       |
| parent:properties/123       | The property with property id: 123.       |
| ancestor:accounts/123       | The account with account id: 123.         |
| firebase_project:project-id | The firebase project with id: project-id. |
| firebase_project:123        | The firebase project with number: 123.    |
pageSize

integer

반환할 최대 리소스 수입니다. 추가 페이지가 있어도 서비스에서 이 값보다 더 적은 값을 반환할 수 있습니다. 지정하지 않으면 최대 50개의 리소스가 반환됩니다. 최댓값은 200입니다(값이 높을수록 최댓값으로 강제 변환됨).
pageToken

string

이전 properties.list 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지로 나눌 때 properties.list에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.
showDeleted

boolean

결과에 소프트 삭제된 (예: '휴지통') 속성을 포함할지 여부입니다. 속성을 검사하여 삭제 여부를 판단할 수 있습니다.

요청 본문

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

응답 본문

properties.list RPC의 응답 메시지입니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "properties": [
    {
      object (Property)
    }
  ],
  "nextPageToken": string
}
입력란
properties[]

object (Property)

필터 기준과 일치하고 호출자가 액세스할 수 있는 결과입니다.
nextPageToken

string

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

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics.edit