API 연결

소개

Linking API는 Looker Studio 보고서를 구성하고 URL을 통해 사용자를 보고서로 직접 안내하는 안정적인 인터페이스를 제공합니다. 사용자가 연결 API URL을 클릭하면 데이터를 빠르게 확인하고 데이터와 상호작용하는 간소화된 환경으로 이동할 수 있습니다.

이 문서에서는 연결 API URL의 필수 형식과 사용 가능한 매개변수를 설명합니다.

사용 사례 및 이점

Linking API를 사용하여 고객이 데이터를 보고 데이터와 상호작용할 수 있는 사전 구성된 보고서를 제공할 수 있습니다. 연결 API의 주요 이점은 다음과 같습니다.

고객을 위한 원클릭 보고서 생성 환경
- 데이터 구성은 URL에 제공되므로 사용자가 데이터에 대한 보고서를 구성할 필요가 없습니다.
- 사용자는 클릭 한 번으로 보고서를 저장하고 언제든지 보고서를 다시 확인할 수 있습니다.
대규모로 보고서 만들기 연결 API를 사용하면 보고서를 복제하거나 새로 만드는 데 필요한 시간이 줄어듭니다.
제품 통합 사용 설정 안정적인 인터페이스를 사용하면 Looker Studio를 제품 워크플로에 통합할 수 있습니다.

작동 방식

다음은 개발자와 사용자가 연결 API와 상호작용하는 방법을 설명합니다.

Linking API 개발자 워크플로

개발자가 템플릿 보고서와 데이터 소스를 준비하고 Linking API URL을 포맷합니다. 개발자의 일반적인 워크플로는 다음과 같습니다.

빈 보고서, Looker Studio에서 제공하는 기본 보고서 템플릿을 사용할지 아니면 템플릿으로 사용할 Looker Studio 보고서를 만들지 결정합니다. 여기에는 템플릿 데이터 소스 구성이 포함됩니다.
특정 사용 사례에 맞게 Linking API URL을 형식화합니다. 해당하는 경우 보고서 이름, 데이터 소스 이름, 데이터 소스 구성을 비롯한 보고서 템플릿 및 기타 매개변수를 지정합니다.
Linking API URL을 사용하여 사용자를 보고서로 안내합니다.

Linking API 사용자 환경

사용자가 Linking API URL을 클릭하면 개발자가 올바르게 구성한 경우 액세스 권한이 있는 데이터를 보고 상호작용할 수 있는 Looker Studio 보고서로 이동합니다. 일반적인 사용자 환경은 다음과 같습니다.

브라우저에서 사용자가 연결 API와 통합된 서비스를 방문합니다.
클릭 유도 문구는 사용자가 링크를 클릭하여 Looker Studio에서 데이터를 볼 수 있도록 안내합니다.
사용자가 링크를 따라 Looker Studio 보고서로 이동합니다. 보고서가 로드되고 사용자가 데이터를 보고 상호작용할 수 있습니다.
사용자가 '수정 및 공유'를 클릭합니다. 보고서가 사용자의 Looker Studio 계정에 저장됩니다.
이제 사용자는 보고서의 자체 사본에 대한 모든 액세스 권한과 제어 권한을 갖습니다. 언제든지 보고, 수정하고, 공유할 수 있습니다.

요구사항

연결 API URL이 예상대로 작동하려면 다음이 필요합니다.

템플릿으로 사용할 보고서입니다. 제공되지 않은 경우 Looker Studio에서 제공하는 빈 보고서 또는 기본 보고서를 사용할 수 있습니다.
Linking API URL 사용자는 최소한 템플릿 보고서에 대한 보기 권한이 있어야 합니다. 보고서에 사용된 데이터 소스의 유형과 연결 API를 통해 제공된 구성에 따라 사용자에게 데이터 소스에 대한 보기 액세스 권한이 필요할 수도 있습니다. 자세한 내용은 템플릿 권한을 참고하세요.
각 데이터 소스의 커넥터 유형은 연결 API를 통한 구성을 지원해야 합니다. 지원되는 커넥터 목록은 커넥터 참조를 참고하세요.
Linking API URL 사용자는 Linking API URL에 구성된 데이터에 액세스할 수 있어야 합니다. 사용자가 기본 데이터에 액세스할 수 없는 경우 종속 보고서 구성요소에 오류가 표시됩니다.

URL 매개변수

연결 API URL은 다음 형식이어야 합니다.

https://lookerstudio.google.com/reporting/create?parameters

URL은 일반적으로 사용자가 링크를 클릭하거나 URL로 리디렉션되는 웹브라우저 컨텍스트에서 사용됩니다. 보고서를 삽입하는 데도 사용할 수 있습니다.

URL 예

다음은 연결 API URL의 예입니다. 보고서 이름이 설정되고 단일 BigQuery 데이터 소스가 구성됩니다.

https://lookerstudio.google.com/reporting/create?
  c.reportId=12345
  &r.reportName=MyNewReport
  &ds.ds0.connector=bigQuery
  &ds.ds0.datasourceName=MyNewDataSource
  &ds.ds0.projectId=project-1234
  &ds.ds0.type=TABLE
  &ds.ds0.datasetId=456
  &ds.ds0.tableId=789

일부 URL 매개변수는 필수이고 일부는 선택사항입니다. 다음은 연결 API URL을 정의하는 데 사용되는 매개변수 목록입니다.

제어 매개변수

제어 매개변수는 연결 API URL을 통해 볼 때 보고서의 상태를 결정합니다.

매개변수 이름	설명
`c.reportId`	선택사항입니다. 템플릿 보고서 ID입니다. Looker Studio가 열리고 지정된 보고서가 구성됩니다. ID를 찾는 방법에 관한 자세한 내용은 신고 ID를 참고하세요. 지정하지 않으면 빈 보고서 또는 기본 보고서 템플릿이 사용됩니다. 자세한 내용은 빈 보고서 또는 기본 보고서 사용을 참고하세요.
`c.pageId`	선택사항입니다. 보고서에서 로드할 초기 페이지의 ID입니다. 지정하지 않으면 보고서의 첫 번째 페이지가 기본값입니다.
`c.mode`	선택사항입니다. 초기 보고 모드입니다. `view` 또는 `edit` 중 하나입니다. 지정되지 않은 경우 기본값은 `view`입니다.
`c.explain`	선택사항입니다. 정보/디버그 대화상자의 공개 상태입니다. 대화상자 버튼을 표시하려면 `true`로 설정합니다. 지정되지 않은 경우 기본값은 `false`입니다. 자세한 내용은 구성 문제 해결을 참고하세요.

예

https://lookerstudio.google.com/reporting/create?
  c.reportId=12345
  &c.pageId=g7u8s9
  &c.mode=edit
  &r.reportName=MyNewReport
  &ds.ds0.datasourceName=MyNewDataSource
  &ds.ds0.connector=bigQuery
  &ds.ds0.projectId=project-1234
  &ds.ds0.type=TABLE
  &ds.ds0.datasetId=456
  &ds.ds0.tableId=789

보고서 매개변수

보고서 매개변수는 보고서 속성을 재정의합니다.

매개변수 이름 설명

매개변수 이름	설명
`r.reportName`	선택사항입니다. 보고서 이름을 설정합니다. 지정하지 않으면 기본적으로 템플릿 보고서 이름이 사용됩니다.
`r.measurementId`	선택사항입니다. 보고서 사용을 측정하도록 Google 애널리틱스 측정 ID를 설정합니다. ID가 여러 개일 경우 쉼표를 사용하여 구분합니다. `r.measurementId` 및 `r.keepMeasurementId`이 지정되지 않은 경우 Google 애널리틱스 측정 ID 보고서 설정은 기본적으로 설정되지 않음으로 설정됩니다. `r.measurementId`와 `r.keepMeasurementId`가 모두 설정된 경우 `r.keepMeasurementId`가 우선 적용되어 ID를 설정합니다.
`r.keepMeasurementId`	선택사항입니다. Google 애널리틱스 측정 ID 템플릿 보고서를 사용하려면 `true`로 설정합니다. 지정되지 않은 경우 기본값은 `false`입니다. `r.measurementId` 및 `r.keepMeasurementId`이 지정되지 않은 경우 Google 애널리틱스 측정 ID 보고서 설정은 기본적으로 설정되지 않음으로 설정됩니다. `r.measurementId`와 `r.keepMeasurementId`가 모두 설정된 경우 `r.keepMeasurementId`가 우선 적용되어 ID를 설정합니다.

r.reportName

선택사항입니다. 보고서 이름을 설정합니다. 지정하지 않으면 기본적으로 템플릿 보고서 이름이 사용됩니다.

r.measurementId

선택사항입니다. 보고서 사용을 측정하도록 Google 애널리틱스 측정 ID를 설정합니다. ID가 여러 개일 경우 쉼표를 사용하여 구분합니다.

r.measurementId 및 r.keepMeasurementId이 지정되지 않은 경우 Google 애널리틱스 측정 ID 보고서 설정은 기본적으로 설정되지 않음으로 설정됩니다. r.measurementId와 r.keepMeasurementId가 모두 설정된 경우 r.keepMeasurementId가 우선 적용되어 ID를 설정합니다.

r.keepMeasurementId

선택사항입니다. Google 애널리틱스 측정 ID 템플릿 보고서를 사용하려면 true로 설정합니다. 지정되지 않은 경우 기본값은 false입니다.

예

https://lookerstudio.google.com/reporting/create?
  c.reportId=12345
  &r.reportName=MyNewReport
  &r.measurementId=G-XXXXXXXXXX
  &ds.ds0.datasourceName=MyNewDataSource
  &ds.ds0.connector=bigQuery
  &ds.ds0.projectId=project-1234
  &ds.ds0.type=TABLE
  &ds.ds0.datasetId=456
  &ds.ds0.tableId=789

데이터 소스 매개변수

데이터 소스 매개변수를 사용하면 템플릿 보고서의 데이터 소스에 액세스할 데이터와 데이터 소스 구성을 정의할 수 있습니다.

alias는 기존 보고서에서 데이터 소스를 참조하는 데 사용됩니다. 별칭을 사용하면 템플릿 보고서에서 데이터 소스를 추가/삭제하는 경우 이전 버전과의 호환성이 유지됩니다.

데이터 소스 alias를 찾는 방법에 관한 자세한 내용은 데이터 소스 별칭을 참고하세요.

데이터 소스 매개변수

다음 매개변수는 모든 커넥터 유형에 공통적으로 적용됩니다.

이름	설명
`ds.alias.datasourceName`	선택사항입니다. 데이터 소스의 이름을 설정합니다. `ds.datasourceName` 및 `ds.keepDatasourceName`이 지정되지 않은 경우 데이터 소스 이름은 커넥터 유형과 생성 시간을 포함하는 명명 규칙으로 기본 설정됩니다 (예: samples - 12/12/21, 10:53 PM). `ds.datasourceName`와 `ds.keepDatasourceName`가 설정된 경우 `ds.datasourceName`가 우선하여 데이터 소스 이름을 설정합니다.
`ds.alias.keepDatasourceName`	선택사항입니다. 템플릿 데이터 소스 이름을 사용하려면 `true`로 설정합니다. 지정되지 않은 경우 기본값은 `false`입니다. `ds.datasourceName` 및 `ds.keepDatasourceName`이 지정되지 않은 경우 데이터 소스 이름은 커넥터 유형과 생성 시간을 포함하는 명명 규칙으로 기본 설정됩니다 (예: samples - 12/12/21, 10:53 PM). `ds.datasourceName`와 `ds.keepDatasourceName`가 설정된 경우 `ds.datasourceName`가 우선하여 데이터 소스 이름을 설정합니다.
`ds.alias.connector`	선택사항입니다. 데이터 소스의 커넥터 유형입니다. 지원되는 커넥터 유형에 대한 자세한 내용은 커넥터 참조를 참고하세요. 설정된 경우 커넥터 유형에 필요한 모든 커넥터 매개변수를 연결 API URL에 지정해야 하며 템플릿 데이터 소스 구성이 전체적으로 대체됩니다. 지정되지 않은 경우 연결 API URL에 커넥터 유형의 커넥터 매개변수를 0개 이상 지정할 수 있습니다. 템플릿 데이터 소스 구성은 연결 API URL에 제공되지 않은 매개변수를 지정하는 데 사용됩니다. 템플릿 데이터 소스의 커넥터 유형을 식별하는 방법에 관한 자세한 내용은 커넥터 유형을 참고하세요. `ds.connector` 파라미터가 템플릿 데이터 소스 구성이 전체적으로 대체되는지 아니면 지정되지 않은 파라미터를 업데이트하는 데 사용되는지에 어떤 영향을 미치는지 자세히 알아보려면 대체와 업데이트 비교를 참고하세요.
`ds.alias.refreshFields`	선택사항입니다. 연결 API를 통해 지정된 데이터 소스 구성을 사용하여 데이터 소스 필드를 새로고침하고 새 필드 선택으로 보고서 구성요소를 업데이트하려면 `true`로 설정합니다. `true`는 일반적으로 커넥터 유형을 전환할 때 또는 구성 변경으로 필드가 달라지는 커넥터 유형(예: BigQuery 데이터 소스의 필드는 테이블 구성에 따라 달라지는 경우가 많음)에 지정됩니다. 템플릿 보고서에서 데이터 소스 필드를 변경하지 않으려면 `false`로 설정합니다. `false`는 일반적으로 새 데이터 구성이 정확히 동일한 필드를 생성하고 템플릿 데이터 소스에 적용한 필드 변경사항을 유지하려는 경우에 지정됩니다. 지정되지 않은 경우 기본값은 커넥터 유형에 따라 다릅니다. 기본 동작을 재정의하려면 커넥터별 기본값을 커넥터 참조에서 검토하세요. `refreshFields` 사용 시 고려사항: `refreshFields`이 `false`로 설정되어 있고 연결 API를 통해 지정된 데이터 소스 구성이 템플릿 보고서에 사용된 필드와 다른 필드를 생성하는 경우 사용자에게 영향을 받는 구성요소에 대한 구성 오류가 표시될 수 있습니다. 템플릿 데이터 소스의 필드 (예: 이름, 유형, 집계 등) 변경사항은 `refreshFields`이 `true`로 설정된 경우 새 데이터 소스로 이전되지 않습니다. 템플릿 데이터 소스의 필드 구성을 유지하려면 `refreshFields`을 `false`로 설정합니다. 템플릿 데이터 소스에 정의된 계산된 필드와 매개변수는 항상 새로 생성된 데이터 소스에 복사되며 `refreshFields` 값의 영향을 받지 않습니다.
`ds.alias.connectorParameters`	필수사항: 커넥터 유형의 데이터 소스 구성입니다. 데이터 소스를 만드는 데 사용된 커넥터를 식별하는 방법에 관한 자세한 내용은 커넥터 유형을 참고하세요. 각 커넥터 유형에 사용할 수 있는 데이터 소스 매개변수에 대한 자세한 내용은 커넥터 참조를 참고하세요.

바꾸기 대 업데이트 - 데이터 소스 구성

데이터 소스 매개변수를 설정할 때 연결 API URL에 ds.connector 매개변수가 있는지 또는 누락되었는지에 따라 템플릿 데이터 소스 구성을 각각 바꾸거나 업데이트할 의도가 표시됩니다.

다음 표에서는 ds.connector 매개변수가 템플릿 데이터 소스 구성이 전체적으로 대체되는지 아니면 지정되지 않은 매개변수를 업데이트하는 데 사용되는지에 미치는 영향을 자세히 설명합니다.

`ds.connector`이 설정되어 있나요?	예상되는 구성 및 동작	일반적인 사용
예	바꾸기. 템플릿 데이터 소스 구성이 연결 API URL에 지정된 데이터 소스 매개변수를 사용하여 전체적으로 대체됩니다. 커넥터 유형에 필요한 모든 매개변수를 지정해야 합니다. `ds.connector`이 설정된 경우 필수 매개변수를 참고하세요.	데이터 소스의 커넥터 유형을 변경하는 경우 예를 들어 템플릿 보고서에서 BigQuery 데이터 소스를 구성했지만 연결 API를 통해 Sheets 데이터 소스를 구성하려는 경우입니다. 이 경우 전체적으로 새 커넥터 구성을 정의해야 합니다. 데이터 소스의 구성을 보장하려는 경우 구성을 대체하면 템플릿 데이터 소스에서 알 수 없는 값이 사용될 수 있는 상황을 방지할 수 있습니다.
아니요	업데이트 템플릿 데이터 소스 구성은 연결 API URL에 제공되지 않은 매개변수를 지정하는 데 사용됩니다. 커넥터 유형의 모든 커넥터 매개변수는 달리 명시되지 않는 한 선택사항입니다. 이렇게 하면 연결 API URL이 간소화되며 템플릿 데이터 소스 구성에 익숙하고 일부 매개변수만 재정의하려는 경우 일반적으로 권장됩니다.	템플릿 데이터 소스와 다른 매개변수 값만 제공하고 지정되지 않은 커넥터 매개변수에 대해서는 템플릿 데이터 소스를 사용해도 되는 경우 예를 들어 BigQuery 데이터 소스 구성의 결제 프로젝트 ID만 변경하고 다른 모든 매개변수에는 템플릿 구성을 사용합니다.

`ds.connector`이 설정된 경우 필수 매개변수

데이터 소스의 ds.connector 매개변수가 지정된 경우 필수로 지정된 모든 커넥터 매개변수를 데이터 소스에 지정해야 합니다. 데이터 소스의 ds.connector 매개변수가 지정되지 않은 경우, 필수 매개변수를 포함한 모든 커넥터 매개변수는 별도의 언급이 없는 한 선택사항으로 처리될 수 있습니다.

예

단일 BigQuery 데이터 소스 (ds0)로 보고서를 구성하고 데이터 소스 구성을 전체적으로 대체합니다.

https://lookerstudio.google.com/reporting/create?
  c.reportId=12345
  &r.reportName=MyNewReport
  &ds.ds0.datasourceName=MyNewDataSource
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=bigquery-public-data
  &ds.ds0.datasetId=samples
  &ds.ds0.tableId=shakespeare

보고서에 데이터 소스가 하나만 있는 경우 데이터 소스 별칭을 생략할 수 있습니다. 위 URL은 다음과 같이 간소화할 수 있습니다.

https://lookerstudio.google.com/reporting/create?
  c.reportId=12345
  &r.reportName=MyNewReport
  &ds.datasourceName=MyNewDataSource
  &ds.connector=bigQuery
  &ds.type=TABLE
  &ds.projectId=bigquery-public-data
  &ds.datasetId=samples
  &ds.tableId=shakespeare

단일 BigQuery 데이터 소스 (ds0)로 보고서를 구성하고 데이터 소스의 결제 프로젝트 ID만 업데이트합니다.

https://lookerstudio.google.com/reporting/create?
  c.reportId=12345
  &r.reportName=MyNewReport
  &ds.ds0.billingProjectId=my-billing-project

BigQuery 데이터 소스 (ds0)와 Google 애널리틱스 데이터 소스 (ds1)라는 두 개의 데이터 소스를 사용하여 보고서를 구성합니다. BigQuery 데이터 소스 구성은 전체가 대체되는 반면 Google 애널리틱스 구성은 단일 매개변수를 업데이트하고 지정되지 않은 커넥터 매개변수에 ds1 템플릿 데이터 소스를 사용합니다.

https://lookerstudio.google.com/reporting/create?
  c.reportId=7890
  &r.reportName=MyNewReportWithMultipleDataSources
  &ds.ds0.datasourceName=MyNewDataSource
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=bigquery-public-data
  &ds.ds0.datasetId=samples
  &ds.ds0.tableId=shakespeare
  &ds.ds1.viewId=92320289

만들기와 추가 비교하기

데이터 소스를 업데이트하면 모든 보고서에 영향을 미치도록 여러 보고서에 동일한 데이터 소스를 사용하는 것이 유용한 경우가 있습니다. Linking API로 보고서를 만들 때 다음 조건을 모두 충족하면 템플릿 보고서에서 데이터 소스를 다시 추가할 수 있습니다.

데이터 소스를 재사용할 수 있습니다 (삽입된 데이터 소스와 재사용 가능한 데이터 소스 비교 참고).
URL이 별칭으로 데이터 소스를 참조하지 않습니다.
URL이 와일드 카드 별칭을 사용하지 않습니다 (데이터 소스 별칭 와일드 카드 참고).

연결 API를 사용하여 새 데이터 소스를 만들면 URL을 클릭한 사용자의 사용자 인증 정보가 사용됩니다. 즉, 사용자에게 기본 데이터에 대한 액세스 권한이 있어야 연결이 작동합니다. 새로 생성된 보고서에 데이터 소스를 다시 추가하면 사용자 인증 정보를 보존하여 사용자가 새 보고서에서 데이터를 계속 액세스할 수 있습니다.

데이터 소스 별칭 와일드 카드

연결 API 매개변수를 여러 데이터 소스에 적용하려면 데이터 소스 별칭 대신 와일드 카드 별칭 ds.*를 사용하면 됩니다.

이는 URL에서 반복되는 매개변수를 삭제하는 데 유용합니다. 예를 들어 BigQuery 데이터 소스가 3개 연결된 템플릿이 있고 각 데이터 소스에서 projectId 및 datasetId를 바꾸되 tableId는 유지하려면 다음과 같이 작성하면 됩니다.

  https://lookerstudio.google.com/reporting/create?
  c.reportId=7890
  &ds.ds1.projectId=client-project
  &ds.ds1.datasetId=client-dataset
  &ds.ds2.projectId=client-project
  &ds.ds2.datasetId=client-dataset
  &ds.ds3.projectId=client-project
  &ds.ds3.datasetId=client-dataset

또는 ds.* 와일드 카드를 사용하여 다음과 같은 동일한 URL을 사용할 수 있습니다.

  https://lookerstudio.google.com/reporting/create?
  c.reportId=7890
  &ds.*.projectId=client-project
  &ds.*.datasetId=client-dataset

ds.* 와일드 카드를 사용하지 않는 연결 API에 제공된 매개변수는 와일드 카드를 사용하는 매개변수보다 우선합니다. 위 예에서는 특정 데이터 소스 별칭을 추가하여 와일드 카드의 값을 재정의할 수 있습니다.

  https://lookerstudio.google.com/reporting/create?
  c.reportId=7890
  &ds.*.projectId=client-project
  &ds.*.datasetId=client-dataset
  &ds.ds1.datasetId=client-dataset

일반적으로 매개변수 우선순위는 다음과 같습니다.

특정 별칭 (ds.ds1.datasetId)이 지정된 매개변수
와일드 카드 (ds.*.datasetId)를 사용하여 제공된 매개변수
템플릿 데이터 소스에서 파생된 값(ds.connector가 제공되지 않은 경우)(바꾸기 및 업데이트 참고)
선택사항인 경우 매개변수의 기본값입니다.

커넥터 참조

연결 API는 다음 커넥터와 구성을 지원합니다. 각 커넥터에 대해 사용 가능한 데이터 소스 매개변수 목록이 제공됩니다.

BigQuery

BigQuery 커넥터는 두 가지 유형의 쿼리를 지원합니다. 쿼리할 테이블의 테이블 ID를 제공하는 TABLE 쿼리와 테이블을 쿼리하는 SQL 문을 제공하는 CUSTOM_QUERY입니다.

TABLE 쿼리

type이 TABLE로 설정되어 있고 쿼리할 테이블의 ID를 제공하는 경우 다음 매개변수가 적용됩니다.

매개변수 이름	설명
`ds.alias.connector`	선택사항입니다. BigQuery 커넥터의 경우 `bigQuery`로 설정됩니다. 설정된 경우 제공된 BigQuery 구성으로 데이터 소스를 대체합니다. 바꾸기와 업데이트 비교를 참고하세요.
`ds.alias.type`	필수** 쿼리 유형입니다. `TABLE`로 설정합니다.
`ds.alias.projectId`	필수** 쿼리할 테이블의 프로젝트 ID입니다.
`ds.alias.datasetId`	필수** 쿼리할 테이블의 데이터 세트 ID입니다.
`ds.alias.tableId`	필수** 쿼리할 테이블의 테이블 ID입니다. 날짜 샤딩된 테이블: 날짜 샤딩된 테이블을 쿼리할 때는 * (와일드 카드 문자) 또는 `YYYYMMDD` 접미사가 지원됩니다. 테이블이 Google 애널리틱스, Firebase 애널리틱스 또는 Firebase Crashlytics로 식별되면 지정되지 않는 한 기본 필드 템플릿이 선택됩니다. 필드 템플릿 표 관련 매개변수를 참고하세요.
`ds.alias.billingProjectId`	선택사항입니다. 결제에 사용할 프로젝트의 ID입니다. 설정하지 않으면 `projectId`이 사용됩니다.
`ds.alias.isPartitioned`	선택사항입니다. 테이블이 파티션을 나눈 경우 파티션 나누기 열을 기간 측정기준으로 사용하려면 `true`로 설정합니다. 이는 시간 기반 파티션 나누기 (예: 시간 기반 파티션 나누기 열 또는 `_PARTITIONTIME` 유사 열 사용)에만 적용되며 정수 범위로 파티션을 나눈 테이블에는 적용되지 않습니다. 지정되지 않은 경우 기본값은 `false`입니다. 자세한 내용은 파티션을 나눈 테이블 소개를 참고하세요.
`ds.alias.refreshFields`	선택사항입니다. 지정되지 않은 경우 기본값은 `true`입니다. 자세한 내용은 refreshFields를 참고하세요.

Google 애널리틱스, Firebase 애널리틱스, Crashlytics의 필드 템플릿

Google 애널리틱스, Firebase 애널리틱스 또는 Firebase Crashlytics로 식별된 테이블의 경우 필드 템플릿을 설정하는 데 사용할 수 있는 추가 매개변수가 있습니다. 지정하지 않으면 기본 템플릿이 선택됩니다.

이름	설명
`ds.alias.gaTemplateLevel`	선택사항입니다. 사용할 Google 애널리틱스 필드 템플릿입니다. Google 애널리틱스용 BigQuery Export 테이블을 쿼리할 때만 적용됩니다. `ALL`, `SESSION`, `HITS` 중 하나입니다. Google 애널리틱스 표의 경우 지정하지 않으면 기본값은 `ALL`입니다.
`ds.alias.firebaseTemplateLevel`	선택사항입니다. 사용할 Firebase 애널리틱스 필드 템플릿입니다. Firebase 애널리틱스 테이블의 BigQuery 내보내기를 쿼리할 때만 적용됩니다. `EVENTS`로만 설정할 수 있습니다. Firebase 애널리틱스 테이블의 경우 지정되지 않은 경우 기본값은 `EVENTS`입니다.
`ds.alias.crashlyticsTemplateLevel`	사용할 Firebase Crashlytics 필드 템플릿입니다. `DEFAULT`로만 설정할 수 있습니다. Firebase Crashlytics 테이블의 BigQuery 내보내기를 쿼리하는 경우에만 적용됩니다. Firebase Crashlytics 테이블의 경우 지정되지 않은 경우 기본값은 `DEFAULT`입니다.

맞춤 쿼리

다음 매개변수는 type이 CUSTOM_QUERY로 설정되어 있고 테이블을 쿼리하는 SQL 문을 제공하는 경우에 적용됩니다.

매개변수 이름	설명
`ds.alias.connector`	선택사항입니다. BigQuery 커넥터의 경우 `bigQuery`로 설정됩니다. 설정된 경우 제공된 BigQuery 구성으로 데이터 소스를 대체합니다. 바꾸기와 업데이트 비교를 참고하세요.
`ds.alias.type`	필수** 쿼리 유형입니다. `CUSTOM_QUERY`로 설정합니다.
`ds.alias.sql`	필수** 실행할 SQL 쿼리입니다.
`ds.alias.billingProjectId`	선택사항입니다. 결제에 사용할 프로젝트의 ID입니다. 설정하지 않으면 `projectId`이 사용됩니다. `projectId`이 설정되지 않은 경우 쿼리된 테이블의 프로젝트가 사용됩니다.
`ds.alias.sqlReplace`	선택사항입니다. SQL 쿼리에 적용할 패턴 및 대체 문자열의 쉼표로 구분된 목록입니다. 문자열 대체는 패턴이 일치하는 경우에만 적용됩니다. 패턴과 대체 문자열 쌍을 쉼표로 구분합니다. 예를 들면 `stringPattern1,replacementString1, stringPattern2,replacementString2`입니다.
`ds.alias.refreshFields`	선택사항입니다. 지정되지 않은 경우 기본값은 `true`입니다. 자세한 내용은 refreshFields를 참고하세요.

예시

테이블 ID로 쿼리가 정의된 TABLE 유형 구성:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=bigquery-public-data
  &ds.ds0.datasetId=samples
  &ds.ds0.tableId=shakespeare
  &ds.ds0.billingProjectId=myProject

와일드 카드 문자 접미사를 사용하여 날짜 샤딩된 테이블을 쿼리하는 TABLE 유형 구성:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=price-data
  &ds.ds0.datasetId=samples
  &ds.ds0.tableId=stock_*

YYYYMMDD 접미사를 사용하여 날짜 샤딩된 테이블을 쿼리하는 TABLE 유형 구성:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=price-data
  &ds.ds0.datasetId=samples
  &ds.ds0.tableId=stock_YYYYMMDD

SESSION 필드 템플릿을 사용하여 Google 애널리틱스용 BigQuery 내보내기 테이블을 쿼리하는 TABLE 유형 구성:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=my-gabq-project
  &ds.ds0.datasetId=1234567
  &ds.ds0.tableId=ga_sessions_YYYYMMDD
  &ds.ds0.gaTemplateLevel=SESSION

수집 시간으로 파티션을 나눈 테이블을 쿼리하고 파티션 나누기 열을 기간 측정기준으로 사용하는 TABLE 유형 구성:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=acme-co-logs
  &ds.ds0.datasetId=logs
  &ds.ds0.tableId=logs_table
  &ds.ds0.isPartitioned=true

SQL 문으로 쿼리가 정의된 CUSTOM_QUERY 유형 구성:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=CUSTOM_QUERY
  &ds.ds0.projectId=bigquery-public-data
  &ds.ds0.sql=SELECT%20word%2C%20word_count%20FROM%20%60bigquery-public-data.samples.shakespeare%60
  &ds.ds0.billingProjectId=myProject

SQL 문만 업데이트되고 템플릿 데이터 소스가 나머지 구성에 사용되는 CUSTOM_QUERY 유형 구성:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.sql=SELECT%20corpus%20FROM%20%60bigquery-public-data.samples.shakespeare%60

템플릿 데이터 소스의 SQL 문이 sqlReplace를 사용하여 업데이트되는 CUSTOM_QUERY 유형 구성:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.sqlReplace=bigquery-public-data,new-project,samples,new-dataset

# The following shows a template query before and after sqlReplace is applied.
#
# Template data source custom query:
#   SELECT word, word_count FROM big-query-public-data.samples.shakespeare
#   INNER JOIN
#   SELECT word, word_count FROM big-query-public-data.samples.raleigh
#
# New data source custom query with sqlReplace applied:
#   SELECT word, word_count FROM new-project.new-dataset.shakespeare
#   INNER JOIN
#   SELECT word, word_count FROM new-project.new-dataset.raleigh

Cloud Spanner

매개변수 이름	설명
`ds.alias.connector`	선택사항입니다. Cloud Spanner 커넥터의 경우 `cloudSpanner`로 설정됩니다. 설정된 경우 제공된 Cloud Spanner 구성으로 데이터 소스를 대체합니다. 바꾸기와 업데이트 비교를 참고하세요.
`ds.alias.projectId`	필수** 프로젝트 ID입니다.
`ds.alias.instanceId`	필수** 인스턴스 ID입니다.
`ds.alias.databaseId`	필수** 데이터베이스 ID입니다.
`ds.alias.sql`	필수** 실행할 SQL 쿼리입니다.
`ds.alias.refreshFields`	선택사항입니다. 지정되지 않은 경우 기본값은 `true`입니다. 자세한 내용은 refreshFields를 참고하세요.

예

SQL 문이 포함된 Cloud Spanner 구성:

https://lookerstudio.google.com/reporting/create?
  c.reportId=456def
  &ds.ds1.connector=cloudSpanner
  &ds.ds1.projectId=myProject
  &ds.ds1.instanceId=production
  &ds.ds1.datasetId=transactions
  &ds.ds1.sql=SELECT%20accountId%2C%20date%2C%20revenue%20FROM%20sales%3B

커뮤니티 커넥터

매개변수 이름	설명
`ds.alias.connector`	선택사항입니다. 커뮤니티 커넥터의 경우 `community`로 설정됩니다. 설정된 경우 데이터 소스를 제공된 커뮤니티 커넥터 구성으로 대체합니다. 바꾸기와 업데이트 비교를 참고하세요.
`ds.alias.connectorId`	필수** 커뮤니티 커넥터 `connectorId` (`deploymentId`이라고도 함)
`ds.alias.parameters`	선택사항입니다. 커뮤니티 커넥터의 커넥터 구성에 정의된 추가 커넥터별 매개변수입니다.
`ds.alias.refreshFields`	선택사항입니다. 지정되지 않은 경우 기본값은 `true`입니다. 자세한 내용은 refreshFields를 참고하세요.

예

state 및 city 구성 매개변수를 사용하여 커뮤니티 커넥터에 연결합니다.

https://lookerstudio.google.com/reporting/create?
  c.reportId=161718pqr
  &ds.ds5.connector=community
  &ds.ds5.connectorId=AqwqXxQshl94nJa0E0-1MsZXQL0DfCsJIMWk7dnx
  &ds.ds5.state=CA
  &ds.ds5.city=Sacramento

Google 애널리틱스

매개변수 이름	설명
`ds.alias.connector`	선택사항입니다. Google 애널리틱스 커넥터의 경우 `googleAnalytics`로 설정됩니다. 설정된 경우 데이터 소스를 제공된 Google 애널리틱스 구성으로 바꿉니다. 바꾸기와 업데이트 비교를 참고하세요.
`ds.alias.accountId`	필수** 계정 ID입니다.
`ds.alias.propertyId`	필수** 속성 ID입니다.
`ds.alias.viewId`	보기 ID입니다. 유니버설 애널리틱스 속성의 경우 필수**입니다. Google 애널리틱스 4 속성의 경우 설정하지 마세요.
`ds.alias.refreshFields`	선택사항입니다. 지정되지 않은 경우 기본값은 `false`입니다. 자세한 내용은 refreshFields를 참고하세요.

예시

유니버설 애널리틱스 속성의 Google 애널리틱스 구성:

https://lookerstudio.google.com/reporting/create?
  c.reportId=789ghi
  &ds.ds2.connector=googleAnalytics
  &ds.ds2.accountId=54516992
  &ds.ds2.propertyId=UA-54516992-1
  &ds.ds2.viewId=92320289

Google 애널리틱스 4 속성의 Google 애널리틱스 구성:

https://lookerstudio.google.com/reporting/create?
  c.reportId=789ghi
  &ds.ds2.connector=googleAnalytics
  &ds.ds2.accountId=54516992
  &ds.ds2.propertyId=213025502

Google Cloud Storage

매개변수 이름	설명
`ds.alias.connector`	선택사항입니다. `googleCloudStorage` Google Cloud Storage 커넥터로 설정합니다. 설정된 경우 데이터 소스를 제공된 Google Cloud Storage 구성으로 대체합니다. 바꾸기와 업데이트 비교를 참고하세요.
`ds.alias.pathType`	필수** 경로 유형입니다. `FILE`를 사용하여 단일 파일을 선택하거나 `FOLDER`를 사용하여 지정된 경로의 모든 파일을 선택합니다.
`ds.alias.path`	필수** `pathType`이 `FILE`인 경우 파일 경로 (예: MyBucket/MyData/MyFile.csv)이고 `pathType`이 `FOLDER`인 경우 폴더 경로 (예: *MyBucket/MyData)입니다.
`ds.alias.refreshFields`	선택사항입니다. 지정되지 않은 경우 기본값은 `true`입니다. 자세한 내용은 refreshFields를 참고하세요.

예

단일 파일의 Google Cloud Storage 구성:

https://lookerstudio.google.com/reporting/create?
  c.reportId=231908kpf
  &ds.ds50.connector=googleCloudStorage
  &ds.ds50.pathType=FILE
  &ds.ds50.path=MyBucket%2FMyData%2FMyFile.csv

경로에 있는 모든 파일의 Google Cloud Storage 구성:

https://lookerstudio.google.com/reporting/create?
  c.reportId=231908kpf
  &ds.ds50.connector=googleCloudStorage
  &ds.ds50.pathType=FOLDER
  &ds.ds50.path=MyBucket%2FMyData

Google Sheets

매개변수 이름	설명
`ds.alias.connector`	선택사항입니다. Google Sheets 커넥터의 경우 `googleSheets`로 설정됩니다. 설정된 경우 제공된 Google Sheets 구성으로 데이터 소스를 대체합니다. 바꾸기와 업데이트 비교를 참고하세요.
`ds.alias.spreadsheetId`	필수** 스프레드시트 ID입니다.
`ds.alias.worksheetId`	필수** 워크시트 ID입니다.
`ds.alias.hasHeader`	선택사항입니다. 첫 번째 행을 헤더로 사용하려면 `true`로 설정합니다. 지정되지 않은 경우 기본값은 `true`입니다. 열 헤더는 고유해야 합니다. 헤더가 비어 있는 항목은 데이터 소스에 추가되지 않습니다.
`ds.alias.includeHiddenCells`	선택사항입니다. 숨겨진 셀을 포함하려면 `true`로 설정합니다. 지정되지 않은 경우 기본값은 `true`입니다.
`ds.alias.includeFilteredCell`	선택사항입니다. 필터링된 셀을 포함하려면 `true`로 설정합니다. 지정되지 않은 경우 기본값은 `true`입니다.
`ds.alias.range`	선택사항입니다. 범위(예: A1:B52)
`ds.alias.refreshFields`	선택사항입니다. 지정되지 않은 경우 기본값은 `true`입니다. 자세한 내용은 refreshFields를 참고하세요.

예시

Google Sheets 구성:

https://lookerstudio.google.com/reporting/create?
  c.reportId=101112jkl
  &ds.ds3.connector=googleSheets
  &ds.ds3.spreadsheetId=1Qs8BdfxZXALh6vX4zrE7ZyGnR3h5k
  &ds.ds3.worksheetId=903806437

첫 번째 행이 헤더로 사용되고 숨겨진 셀과 필터링된 셀이 포함된 Google Sheets 구성:

https://lookerstudio.google.com/reporting/create?
  c.reportId=101112jkl
  &ds.ds3.connector=googleSheets
  &ds.ds3.spreadsheetId=1Qs8BdfxZXALh6vX4zrE7ZyGnR3h5k
  &ds.ds3.worksheetId=903806437
  &ds.ds3.hasHeader=true
  &ds.ds3.includeHiddenCells=true
  &ds.ds3.includeFilteredCells=true

범위 (A1:D20)가 있는 Google Sheets 구성:

https://lookerstudio.google.com/reporting/create?
  c.reportId=101112jkl
  &ds.ds3.connector=googleSheets
  &ds.ds3.spreadsheetId=1Qs8BdfxZXALh6vX4zrE7ZyGnR3h5k
  &ds.ds3.worksheetId=903806437
  &ds.ds3.range=A1%3AD20

Looker

매개변수 이름	설명
`ds.alias.connector`	선택사항입니다. Looker 커넥터의 경우 `looker`로 설정됩니다. 설정된 경우 데이터 소스를 제공된 Looker 구성으로 대체합니다. 바꾸기와 업데이트 비교를 참고하세요.
`ds.alias.instanceUrl`	필수** Looker 인스턴스 URL입니다.
`ds.alias.model`	필수** Looker 모델입니다.
`ds.alias.explore`	필수** Looker Explore입니다.
`ds.alias.refreshFields`	선택사항입니다. 지정되지 않은 경우 기본값은 `false`입니다. 자세한 내용은 refreshFields를 참고하세요.

예

Looker Explore에 연결합니다.

https://lookerstudio.google.com/reporting/create?
  c.reportId=161718pqr
  &ds.ds5.connector=looker
  &ds.ds5.instanceUrl=my.looker.com
  &ds.ds5.model=thelook
  &ds.ds5.explore=orders

Search Console

매개변수 이름	설명
`ds.alias.connector`	선택사항입니다. Search Console 커넥터의 경우 `searchConsole`로 설정됩니다. 설정된 경우 제공된 Search Console 구성으로 데이터 소스를 대체합니다. 바꾸기와 업데이트 비교를 참고하세요.
`ds.alias.siteUrl`	필수** 사이트 URL입니다. 도메인 속성의 경우 `sc-domain\:`를 접두사로 사용합니다.
`ds.alias.tableType`	필수** 테이블 유형을 설정합니다. `SITE_IMPRESSION` 또는 `URL_IMPRESSION` 중 하나일 수 있습니다.
`ds.alias.searchType`	필수** 검색 유형을 설정합니다. `WEB`, `IMAGE`, `VIDEO` 또는 `NEWS` 중 하나일 수 있습니다.
`ds.alias.refreshFields`	선택사항입니다. 지정되지 않은 경우 기본값은 `false`입니다. 자세한 내용은 refreshFields를 참고하세요.

예

URL 접두사 속성의 Search Console 구성:

https://lookerstudio.google.com/reporting/create?
  c.reportId=161718pqr
  &ds.ds5.connector=searchConsole
  &ds.ds5.siteUrl=https%3A%2F%2Fwww.example.com%2Fwelcome
  &ds.ds5.tableType=SITE_IMPRESSION
  &ds.ds5.searchType=WEB

도메인 속성의 Search Console 구성:

https://lookerstudio.google.com/reporting/create?
  c.reportId=161718pqr
  ds.ds5.connector=searchConsole
  &ds.ds5.siteUrl=sc-domain%3Aexample.com
  &ds.ds5.tableType=SITE_IMPRESSION
  &ds.ds5.searchType=WEB

템플릿 권한

사용자에게 최상의 사용자 환경을 제공하려면 템플릿 보고서 및 연결된 데이터 소스에 대한 보고서 액세스 권한을 올바르게 설정해야 합니다. 필요한 권한은 보고서 템플릿에서 삽입된 데이터 소스를 사용하는지 아니면 재사용 가능한 데이터 소스를 사용하는지, 그리고 연결 API 구성이 데이터 소스 구성을 바꾸기로 설정되어 있는지 아니면 업데이트로 설정되어 있는지에 따라 달라집니다.

다음 표에는 템플릿 데이터 소스 및 연결 API 구성에 따라 최적의 사용자 환경을 위해 권장되는 데이터 소스 액세스가 나와 있습니다.

데이터 소스 유형	데이터 소스의 연결 API 구성	데이터 소스 권한 권장사항	참고
임베디드	바꾸기	해당 사항 없음 - 보기 액세스 권한은 보고서에서 상속됩니다.	사용자에게 템플릿 보고서에 대한 보기 액세스 권한이 있으면 삽입된 데이터 소스에 대한 보기 액세스 권한이 자동으로 부여됩니다.
임베디드	업데이트	해당 사항 없음 - 보기 액세스 권한은 보고서에서 상속됩니다.	사용자에게 템플릿 보고서에 대한 보기 액세스 권한이 있으면 삽입된 데이터 소스에 대한 보기 액세스 권한이 자동으로 부여됩니다.
재사용이 가능함	바꾸기	사용자에게 보기 액세스 권한이 필요하지 않습니다.	데이터 소스 구성이 연결 API를 통해 전체적으로 대체되므로 보기 액세스가 필요하지 않습니다.
재사용이 가능함	업데이트	사용자에게 보기 액세스 권한이 필요합니다.	연결 API가 템플릿 데이터 소스의 구성을 읽고 사용하려면 데이터 소스에 대한 보기 액세스 권한이 필요합니다. 사용자에게 보기 액세스 권한이 없으면 보고서를 로드할 때 오류가 표시됩니다.

빈 보고서 또는 기본 보고서 사용

빈 보고서 또는 기본 보고서를 사용하려면 다음과 같이 연결 API를 구성하세요.

보고서 유형 reportId 제어 매개변수 설정 데이터 소스 (ds) 매개변수를 설정합니다. 참고

빈 보고서 아니요 아니요

기본 보고서

아니요

예

보고서 유형	`reportId` 제어 매개변수 설정	데이터 소스 (`ds`) 매개변수를 설정합니다.	참고
빈 보고서	아니요	아니요
기본 보고서	아니요	예	기본 보고서는 Looker Studio에서 제공합니다. 기본 보고서에는 삽입된 데이터 소스가 하나만 있으므로 기본 보고서의 데이터 소스 매개변수를 지정할 때는 데이터 소스 별칭을 사용하지 않아도 됩니다.

기본 보고서는 Looker Studio에서 제공합니다.

기본 보고서에는 삽입된 데이터 소스가 하나만 있으므로 기본 보고서의 데이터 소스 매개변수를 지정할 때는 데이터 소스 별칭을 사용하지 않아도 됩니다.

다음 예는 빈 보고서 또는 기본 보고서를 사용하는 다양한 연결 API URL을 보여줍니다.

빈 보고서로 보고서 생성 워크플로를 시작합니다.

https://lookerstudio.google.com/reporting/create

빈 보고서로 보고서 생성 워크플로를 시작하고 보고서 이름을 설정합니다.

https://lookerstudio.google.com/reporting/create?r.reportName=MyNewReport

Google Sheets 커넥터 구성과 함께 기본 보고서 템플릿을 사용합니다.

https://lookerstudio.google.com/reporting/create?
  ds.connector=googleSheets
  &ds.spreadsheetId=1Q-w7KeeJj1jk3wFcFm4NsPlppNscs0CtHf_EP9fsYOo
  &ds.worksheetId=0

보고서 삽입하기

Linking API로 만든 보고서를 삽입하려면 URL 매개변수를 설정하고 /embed/ 경로를 포함합니다. 연결 API 삽입 URL은 다음 형식이어야 합니다.

https://lookerstudio.google.com/embed/reporting/create?parameters

ID 및 별칭 찾기

보고서 ID

보고서 ID를 찾는 방법은 다음과 같습니다.

템플릿으로 사용할 보고서를 엽니다. 보고서의 URL을 검사합니다. reporting/와 /page 사이의 부분이 보고서 ID입니다. 예를 들어 다음 URL에서 0B_U5RNpwhcE6SF85TENURnc4UjA은 보고서 ID입니다.

https://lookerstudio.google.com/reporting/0B_U5RNpwhcE6SF85TENURnc4UjA/page/1M

Looker Studio 보고서의 URL이 표시된 브라우저 주소 표시줄
보고서 ID가 강조 표시되어 있습니다. — 보고서 URL에서 보고서 ID를 찾습니다.

데이터 소스 별칭

보고서에는 여러 데이터 소스가 있을 수 있습니다. 데이터 소스는 별칭으로 참조해야 합니다.

데이터 소스 별칭을 찾으려면 다음 단계를 따르세요.

보고서를 수정합니다.
툴바에서 리소스 > 추가된 데이터 소스 관리를 선택합니다.
별칭 열을 검토하여 각 데이터 소스의 별칭 정보를 확인합니다.

데이터 소스가 추가되거나 삭제될 때 하위 호환성을 보장하기 위해 별칭 이름을 수정할 수 있습니다.

데이터 소스 리소스 관리 페이지의 데이터 소스 목록
별칭 열이 강조 표시됩니다. — *데이터 소스* 관리 페이지에서 데이터 소스 별칭을 찾습니다.

커넥터 유형

보고서에는 커넥터를 구성하여 만든 데이터 소스가 여러 개 있을 수 있습니다. 데이터 소스를 만드는 데 사용된 커넥터 유형을 확인하려면 다음 단계를 따르세요.

보고서를 수정합니다.
툴바에서 리소스 > 추가된 데이터 소스 관리를 선택합니다.
커넥터 유형 열을 검토하여 데이터 소스를 만드는 데 사용된 커넥터를 확인합니다.

데이터 소스 리소스 관리 페이지의 데이터 소스 목록
커넥터 유형 열이 강조 표시됩니다. — *데이터 소스* 관리 페이지에서 데이터 소스 커넥터 유형을 찾습니다.

팁 및 문제 해결 방법

문제가 있는 경우 아래 세부정보를 검토하여 잠재적인 문제와 일반적인 잘못된 구성을 파악하세요.

디버그 대화상자

디버그 대화상자를 사용하여 Looker Studio에서 해석한 Linking API 구성을 검토합니다. API 문제를 디버깅하는 데 도움이 될 수 있습니다.

연결 API URL을 파싱하는 중에 오류가 발생하면 오류에 관한 세부정보가 포함된 대화상자가 자동으로 표시됩니다.
오류가 발생했는데 대화상자가 자동으로 표시되지 않으면 보고서 오른쪽 상단에 있는 정보 버튼을 찾습니다. 추가 디버그 정보를 보려면 클릭하세요.
정보 버튼을 사용할 수 없는 경우 연결 API URL 끝에 &c.explain=true 매개변수를 추가하여 버튼을 사용 설정할 수 있습니다.

권한

데이터 소스 유형 및 연결 API 구성에 올바른 템플릿 권한이 설정되어 있는지 확인합니다. 자세한 내용은 템플릿 권한을 참고하세요.

업데이트와 바꾸기 비교

데이터 소스 템플릿에서 데이터 소스 구성을 업데이트하는 경우 템플릿 데이터 소스 구성과 연결 API 구성을 검토하여 호환되는지 확인하세요. 새 구성에서 생성된 필드가 보고서 구성요소 및 구성과 호환되는지 확인합니다.

업데이트와 교체를 수행할 때 정의되지 않은 동작으로 잘못된 구성을 설정할 수 있습니다. 자세한 내용은 바꾸기 및 업데이트를 참고하세요.

필드 새로고침

템플릿 데이터 소스의 필드 이름, 유형 또는 집계를 구성한 경우 ds.refreshFields 매개변수가 false로 설정된 경우에만 이러한 변경사항이 Linking API 구성 데이터 소스로 이전됩니다.

연결 API URL의 ds.refreshFields 데이터 소스 매개변수를 검토합니다. 생략된 경우 각 커넥터 유형의 매개변수 기본값이 사용 사례에 적합한지 확인합니다.

일반적으로 템플릿 데이터 소스에서 필드를 구성했고 연결 API를 통한 새 데이터 소스 구성이 항상 정확히 동일한 필드를 생성한다고 확신하는 경우 refreshFields을 false로 설정하는 것이 좋습니다.

예를 들어 보고서 템플릿을 만드는 동안 Looker Studio에서 특정 데이터 소스 필드를 숫자 유형으로 식별하고 이를 연도 유형으로 변경하면 이 필드 구성 변경사항이 이제 템플릿 데이터 소스의 일부가 됩니다. 수정된 필드를 사용하는 보고서 템플릿의 차트는 연도를 예상하며, 차트가 시간 기반인 경우 그렇지 않으면 렌더링되지 않을 수 있습니다. 연결 API를 사용하여 정확히 동일한 필드를 생성하는 새 데이터 소스 구성을 제공하는 경우 refreshFields 매개변수의 값에 따라 두 가지 결과가 있습니다.

true로 설정하면 템플릿 데이터 소스의 필드 구성이 이전되지 않으며, 동일한 필드 구성 (예: 연도 유형의 필드가 필요함)에 따라 차트가 로드되지 않을 수 있습니다.
false로 설정하면 템플릿 데이터 소스의 필드 구성이 새 데이터 소스로 이전되고 보고서 차트가 동일한 구성의 동일한 필드를 수신하여 성공적으로 로드됩니다.

의견 및 지원

Issue Tracker를 사용하여 Linking API 문제를 신고하거나 의견을 제공하세요. 도움을 받고 질문하는 방법에 관한 일반적인 리소스는 지원을 참고하세요.

변경 로그

2023-06-06

Google 애널리틱스 추적 ID 보고서 설정을 구성하기 위해 r.measurementId 및 r.keepMeasurementId 보고서 매개변수가 추가되었습니다.
템플릿 데이터 소스 이름의 재사용을 제어하는 ds.keepDatasourceName가 추가되었습니다.
보고서 삽입 섹션을 추가했습니다.
BigQuery 커넥터
- sqlReplace이 추가되었습니다. 템플릿 데이터 소스의 SQL 쿼리를 업데이트할 패턴과 대체 문자열을 지정할 수 있습니다.

2023-05-22

Looker 커넥터 지원이 추가되었습니다.
커뮤니티 커넥터 지원이 추가되었습니다.

2022-11-21

빈 보고서를 사용할 수 있는 기능이 추가되었습니다. 빈 보고서 또는 기본 보고서 사용하기를 참고하세요.
팁 및 문제 해결에 refreshFields 섹션이 추가되었습니다.

2022-11-14

Google Surveys 지원 중단으로 인해 Surveys 커넥터 참조가 삭제되었습니다.

2022-06-15

베타 종료
- 통합 API의 이름이 연결 API로 변경되었습니다.
- Linking API의 베타 기간이 종료되었습니다.
특정 보고서 페이지로 연결할 수 있도록 pageId 컨트롤 매개변수를 추가했습니다.
로드 시 보고서 상태를 보기 또는 수정 모드로 설정하는 mode 컨트롤 매개변수를 추가했습니다.
이제 데이터 소스 구성을 전체적으로 교체하거나 부분적으로 업데이트할 수 있습니다. 이 동작은 ds.connector 매개변수가 설정되었는지에 따라 결정됩니다. 자세한 내용은 바꾸기 및 업데이트를 참고하세요.
이제 c.reportId 매개변수를 사용하여 보고서 템플릿을 제공하지 않으면 기본 템플릿이 사용됩니다.
ds.refreshFields 데이터 소스 매개변수가 추가되었습니다. 이를 통해 데이터 소스 구성을 로드할 때 데이터 소스 필드를 새로고침할지 여부를 제어할 수 있습니다.
BigQuery 커넥터
- type이 CUSTOM_QUERY로 설정된 경우 projectId는 필요하지 않습니다.
- billingProjectId가 설정되지 않은 경우 결제 프로젝트는 projectId 또는 쿼리된 테이블의 프로젝트로 대체됩니다.
- 날짜 파티션을 나눈 테이블에 대한 지원이 추가되었습니다. 파티션 필드를 기간 측정기준으로 사용하려면 isPartitioned 매개변수를 true로 설정합니다.
- 와일드 카드 문자 또는 YYYYMMDD 테이블 접미사를 사용하여 날짜로 파티션을 나눈 테이블을 쿼리하는 지원이 추가되었습니다.
- Google 애널리틱스, Firebase 애널리틱스 또는 Crashlytics 테이블을 쿼리하고 필드 템플릿을 선택하는 지원이 추가되었습니다.
Google Sheets
- hasHeader는 웹 UI 기본값과 일치하는 true으로 기본 설정됩니다.
- includeHiddenAndFilteredCell가 includeHiddenCells 및
- includeFilteredCells. 이제 둘 다 웹 UI 기본값과 일치하는 true이 기본값입니다.
Search Console 커넥터
- propertyType 매개변수의 이름을 searchType로 변경했습니다.
설문조사 커넥터
- 이제 surveyId는 단일 설문조사 ID 또는 쉼표로 구분된 설문조사 ID 목록을 허용합니다.

2021-12-16

Integration API의 초기 출시입니다.
- 기존 보고서에 연결하고 보고서 이름을 설정하는 기능을 지원합니다.
- 여러 데이터 소스를 구성할 수 있으며 각 데이터 소스 이름을 설정할 수 있습니다.
- BigQuery, Cloud Spanner, Google 애널리틱스, Google Cloud Storage, Google Sheets, Google 설문조사, Search Console 커넥터 유형 지원

API 연결 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

소개

사용 사례 및 이점

작동 방식

Linking API 개발자 워크플로

Linking API 사용자 환경

요구사항

URL 매개변수

제어 매개변수

보고서 매개변수

데이터 소스 매개변수

데이터 소스 매개변수

바꾸기 대 업데이트 - 데이터 소스 구성

ds.connector이 설정된 경우 필수 매개변수

예

만들기와 추가 비교하기

데이터 소스 별칭 와일드 카드

커넥터 참조

BigQuery

TABLE 쿼리

Google 애널리틱스, Firebase 애널리틱스, Crashlytics의 필드 템플릿

맞춤 쿼리

Cloud Spanner

커뮤니티 커넥터

Google 애널리틱스

Google Cloud Storage

Google Sheets

Looker

Search Console

템플릿 권한

빈 보고서 또는 기본 보고서 사용

보고서 삽입하기

ID 및 별칭 찾기

보고서 ID

데이터 소스 별칭

커넥터 유형

팁 및 문제 해결 방법

디버그 대화상자

권한

업데이트와 바꾸기 비교

필드 새로고침

의견 및 지원

변경 로그

2023-06-06

2023-05-22

2022-11-21

2022-11-14

2022-06-15

2021-12-16

API 연결

`ds.connector`이 설정된 경우 필수 매개변수