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

API 연결

소개

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

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

사용 사례 및 이점

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

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

사용 방법

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

Linking API 개발자 워크플로

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

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

Linking API 사용자 환경

사용자가 Linking API URL을 따라갑니다. 개발자가 올바르게 구성한 경우 사용자는 액세스 권한이 있는 데이터를 보고 활용할 수 있는 Looker Studio 보고서로 연결됩니다. 일반적인 사용자 환경은 다음과 같습니다.

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

요구사항

Linking API URL이 예상대로 작동하도록 하려면 다음이 필요합니다.

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

URL 매개변수

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

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

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

URL 예

다음은 Linking 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 매개변수는 필수이며 일부는 선택사항입니다. 다음은 Linking API URL을 정의하는 데 사용되는 매개변수 목록입니다.

제어 매개변수

제어 매개변수는 Linking 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`가 설정된 경우 ID를 설정할 때 `r.keepMeasurementId`가 우선 적용됩니다.
`r.keepMeasurementId`	선택사항입니다. 템플릿 보고서 Google 애널리틱스 측정 ID를 사용하려면 `true`로 설정합니다. 지정되지 않은 경우 기본값은 `false`입니다. `r.measurementId` 및 `r.keepMeasurementId`를 지정하지 않으면 Google 애널리틱스 측정 ID 보고서 설정이 기본적으로 설정되지 않습니다. `r.measurementId`와 `r.keepMeasurementId`가 설정된 경우 ID를 설정할 때 `r.keepMeasurementId`가 우선 적용됩니다.

r.reportName

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

r.measurementId

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

r.measurementId 및 r.keepMeasurementId를 지정하지 않으면 Google 애널리틱스 측정 ID 보고서 설정이 기본적으로 설정되지 않습니다. r.measurementId와 r.keepMeasurementId가 설정된 경우 ID를 설정할 때 r.keepMeasurementId가 우선 적용됩니다.

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

교체 및 업데이트 - 데이터 소스 구성

데이터 소스 매개변수를 설정할 때 Linking API URL에 ds.connector 매개변수가 있는지 여부는 각각 템플릿 데이터 소스 구성을 교체하거나 업데이트하려는 의도를 나타냅니다.

다음 표에서는 ds.connector 매개변수가 템플릿 데이터 소스 구성이 완전히 교체되는지 또는 지정되지 않은 매개변수를 업데이트하는 데 사용되는지 여부에 미치는 영향을 자세히 보여줍니다.

`ds.connector`이(가) 설정되어 있나요?	예상 구성 및 동작	일반 용도
예	바꾸기. 템플릿 데이터 소스 구성은 Linking API URL에 지정된 데이터 소스 매개변수를 사용하여 완전히 대체됩니다. 커넥터 유형에 필요한 모든 매개변수를 지정해야 합니다. `ds.connector` 설정 시 필수 매개변수를 참고하세요.	데이터 소스의 커넥터 유형을 변경할 때 예를 들어 템플릿 보고서에서 BigQuery 데이터 소스를 구성했지만 Linking API를 통해 Sheets 데이터 소스를 구성하려는 경우가 이에 해당합니다. 이렇게 하려면 새 커넥터 구성을 완전히 정의해야 합니다. 데이터 소스의 구성을 보장하려는 경우 구성을 바꾸면 템플릿 데이터 소스에서 알 수 없는 값이 사용되는 것을 방지할 수 있습니다.
아니요	업데이트. 템플릿 데이터 소스 구성은 Linking API URL에 제공되지 않은 매개변수를 지정하는 데 사용됩니다. 별도로 명시되지 않는 한 커넥터 유형의 모든 커넥터 매개변수는 선택사항입니다. 이렇게 하면 Linking 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에 와일드 카드 별칭을 사용하지 않습니다 (데이터 소스 별칭 와일드 카드 참조).

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

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

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

이 기능은 URL에서 반복되는 매개변수를 제거할 때 유용합니다. 예를 들어 3개의 BigQuery 데이터 소스가 연결된 템플릿이 있고 각 템플릿의 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.* 와일드 카드를 사용하지 않는 Linking 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가 제공되지 않은 경우 템플릿 데이터 소스에서 파생된 값(바꾸기와 업데이트 비교 참고)
매개변수의 기본값입니다(선택사항인 경우).

커넥터 참조

Linking 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 Export 테이블을 쿼리하는 경우에만 적용됩니다. `EVENTS`로만 설정할 수 있습니다. Firebase 애널리틱스 테이블의 경우 지정되지 않으면 기본값은 `EVENTS`입니다.
`ds.alias.crashlyticsTemplateLevel`	사용할 Firebase Crashlytics 필드 템플릿입니다. `DEFAULT`로만 설정할 수 있습니다. Firebase Crashlytics 테이블의 BigQuery Export를 쿼리하는 경우에만 적용됩니다. Firebase Crashlytics 테이블의 경우 지정되지 않으면 기본값은 `DEFAULT`입니다.

CUSTOM 쿼리

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 Export를 쿼리하기 위한 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

쿼리하는 CUSTOM_QUERY 유형 구성은 SQL 문으로 정의됩니다.

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

템플릿 권한

사용자에게 최상의 사용자 환경을 제공하려면 템플릿 보고서 및 관련 데이터 소스에 보고서 액세스 권한을 올바르게 설정하는 것이 중요합니다. 필요한 권한은 보고서 템플릿에서 삽입된 데이터 소스와 재사용 가능한 데이터 소스를 사용하는지 여부와 Linking API 구성이 데이터 소스 구성을 교체 또는 업데이트하도록 설정되었는지 여부에 따라 달라집니다.

다음 표에서는 템플릿 데이터 소스 및 Linking API 구성을 기반으로 최적의 사용자 환경을 위한 권장 데이터 소스 액세스 권한을 제공합니다.

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

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

빈 보고서 또는 기본 보고서를 사용하려면 Linking API를 다음과 같이 구성합니다.

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

빈 보고서 아니요 아니요

기본 보고서

아니요

예

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

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

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

다음 예는 빈 보고서 또는 기본 보고서를 사용하는 다양한 Linking 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/ 경로를 포함합니다. Linking 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를 찾습니다.

데이터 소스 별칭

보고서는 여러 개의 데이터 소스를 포함할 수 있습니다. 데이터 소스는 별칭으로 참조해야 합니다.

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

보고서를 수정합니다.
툴바에서 리소스 > 추가된 데이터 소스 관리를 선택합니다.
별칭 열을 살펴보고 각 데이터 소스의 별칭 정보를 찾습니다.

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

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

커넥터 유형

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

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

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

팁 및 문제 해결 방법

문제가 있으면 아래 세부정보를 검토하여 잠재적인 문제와 일반적인 구성 오류를 확인하세요.

디버그 대화상자

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

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

권한

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

업데이트와 교체 비교

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

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

필드 새로고침

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

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

일반적으로 템플릿 데이터 소스에 필드를 구성하고 Linking API를 통해 새로운 데이터 소스 구성이 항상 정확히 동일한 필드를 생성할 것이라면 refreshFields를 false로 설정하는 것이 좋습니다.

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

true로 설정하면 템플릿 데이터 소스의 필드 구성이 이전되지 않으며, 동일한 필드 구성에 종속되는 경우 (즉, Year 유형의 필드가 예상됨) 차트가 로드되지 않을 수 있습니다.
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

베타 기간 종료
- Integration API의 이름이 Linking 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 스프레드시트
- 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 Surveys, Search Console입니다.

API 연결

소개

사용 사례 및 이점

사용 방법

Linking API 개발자 워크플로

Linking API 사용자 환경

요구사항

URL 매개변수

제어 매개변수

보고서 매개변수

데이터 소스 매개변수

데이터 소스 매개변수

교체 및 업데이트 - 데이터 소스 구성

ds.connector 설정 시 필수 매개변수

예시

만들기 및 추가

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

커넥터 참조

BigQuery

TABLE 쿼리

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

CUSTOM 쿼리

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

`ds.connector` 설정 시 필수 매개변수