파트너 커넥터 요구사항

게시 개요를 검토하여 커넥터 게시의 이점과 필요한 약정 수준을 알아보세요. 파트너 커넥터를 게시하려면 커넥터가 아래에 설명된 모든 요구사항을 충족해야 합니다.

Apps Script

검토를 위해 커넥터를 제출하기 전에 Apps Script에서 다음을 완료하세요.

  1. 다음을 사용하여 Apps Script 프로젝트의 보기 액세스를 공유합니다.
  2. Production라는 배포를 만들고 Production 배포를 게시하려는 코드 버전으로 업데이트합니다.
  3. 검토하려는 코드 버전으로 Production 배포를 업데이트했는지 확인합니다.
  4. 매니페스트 파일이 Apps Script에 표시되는지 확인합니다. 왼쪽에서 프로젝트 설정 을 클릭합니다. 편집기에 'appsscript.json' 매니페스트 파일 표시 체크박스를 선택합니다.

매니페스트

커넥터의 매니페스트에 다음을 포함하고 Apps Script 프로젝트가 편집기에 appsscript.json 매니페스트 파일을 표시하도록 구성되어 있는지 확인합니다.

자세한 내용은 커뮤니티 커넥터 매니페스트 참조를 확인하세요.

dataStudio

  1. description 은 커넥터와 커넥터 사용 방법을 기본적으로 이해할 수 있도록 정보와 안내를 제공합니다. 설명이 모호하고 불완전한 커넥터는 거부됩니다.
  2. addOnUrl 은 커넥터에 대한 호스팅된 전용 페이지여야 하며, 자체 도메인에서 호스팅되는 것이 좋습니다. 페이지에는 다음이 포함되어야 합니다.
    • addOnUrl와 동일한 도메인에 있는 개인정보처리방침 및 이용약관 또는 이 콘텐츠로 연결되는 링크.
    • 사용자가 커넥터를 사용하기 위해 알아야 하는 세부정보입니다.
    • 가입 링크(커넥터를 사용하는 데 계정이 필요한 경우)
    • 도메인에 선호되는 콘텐츠 호스팅 https://sites.google.com/에서는 호스팅이 허용되지 않습니다.
    • 기존 파트너의 페이지 예시(Funnel, Supermetrics, CallRail)를 확인하세요.
  3. 커넥터에 대한 지원을 받으려면 supportUrl 이(가) 호스팅된 페이지여야 합니다. 이메일이나 mailto 링크는 사용할 수 없습니다.
  4. logoUrl 는 개발자가 제어하는 하에 호스팅되는 정적 이미지를 가리켜야 합니다. *.gstatic.com, *.ggpht.com, *.google.com, *.googleusercontent.com 등의 도메인에서 Google 서비스가 제공하는 이미지를 사용할 수 없습니다. Google Cloud Storage를 사용하여 *.googleapis.com 도메인에서 이미지를 제공하는 것은 허용되며 권장되는 호스팅 옵션입니다.
    • 애니메이션 아이콘이 포함된 커넥터는 거부됩니다. 정적 이미지를 사용하세요.
    • 최소 48x48픽셀 이미지를 사용하는 것이 좋습니다.
    • 48x48픽셀로 축소할 때 읽기 어려운 텍스트 전용 이미지는 사용하지 않습니다.
  5. 커넥터가 연결되는 모든 소스로 sources 속성을 채웁니다. 자세한 내용은 매니페스트의 소스 참조를 확인하세요.
    • Data Registry 저장소에서 기존 소스 목록을 볼 수 있습니다. 연결하려는 소스가 저장소에 없는 경우 Data Registry Repository로 가져오기 요청을 전송하여 소스를 추가합니다. 매니페스트의 소스가 저장소에 없으면 커넥터가 검토 프로세스를 실패합니다.
    • 갤러리의 검색 기능을 위해 색인이 생성될 커넥터의 추가 메타데이터입니다. 커넥터는 사용자가 갤러리에서 특정 소스를 검색할 때 검색결과에 표시됩니다.
  6. shortDescription, authType, feeType, privacyPolicyUrl, termsOfServiceUrl의 값을 제공합니다.
  7. name 는 커넥터의 목적을 직접적으로 나타내야 합니다. 명확한 이름을 사용하면 사용자가 커넥터의 필요를 충족하는지 확인하는 데 도움이 됩니다. 사용자는 이미 커넥터를 보고 있다는 것을 알고 있으므로 이름에 커넥터라는 단어를 사용하지 않습니다.
    • 커넥터의 위치에 주의를 끌거나 잠재적으로 변경할 목적으로 특수 문자나 보이지 않는 문자를 포함하지 마세요.
  8. 매니페스트의 모든 위치 (예: GDS, DS 등)에서 Looker Studio의 약식 이름을 사용하지 마세요.
  9. 그림 이모티콘은 매니페스트 필드(description, shortDescription, name 등)에서 허용되지 않습니다. 일반적으로 커넥터에 주의를 끌기 위해 특수문자나 보이지 않는 문자는 포함하지 마세요.
  10. 커넥터에 고정 스키마가 있는 경우 커넥터의 보고서 템플릿을 만들어 매니페스트에 추가합니다. 보고서에 대해 링크로 공유를 사용 설정합니다.

urlFetchWhitelist

  1. UrlFetchApp에서 호출하는 엔드포인트 수를 커넥터 기능에 절대적으로 필요한 엔드포인트 수로 제한합니다. 매니페스트의 루트 수준에 urlFetchWhitelist 속성을 추가합니다. 자세한 내용은 urlFetchAllowed 참조를 확인하세요.
    • UrlFetchApp 서비스와 함께 사용되는 모든 엔드포인트를 포함합니다.
    • 커넥터가 UrlFetchApp 서비스를 사용하여 리소스를 가져오지 않으면 urlFetchWhitelist을 빈 목록 []로 설정합니다.
    • 커넥터가 고정된 엔드포인트 집합에 연결되지 않거나 엔드포인트 프리픽스가 다양하면 검토 요청을 제출할 때 urlFetchWhitelist 속성을 생략하고 urlFetchAllowed 양식 필드에 세부정보를 제공합니다.

oauthScopes

  1. 매니페스트에서 명시적 OAuth 범위를 설정합니다. 명시적인 OAuth 범위가 없는 커넥터는 거부됩니다.

커넥터

  1. 사용자가 커넥터를 사용하는 데 계정이 필요한 경우 커넥터 description 또는 addOnUrl 링크가 사용자가 계정을 만드는 데 도움이 되는 안내를 제공하는지 확인합니다.
  2. 커넥터가 미완료 또는 베타 상태일 수 없습니다. 완전하고 제대로 작동하는 커넥터를 게시해야 합니다. 언제든지 커넥터를 업데이트할 수 있지만, 사용자에게 출시된 프로덕션 배포를 테스트하고 기능을 완료해야 합니다.
  3. 사용자에게 커넥터 내부 오류가 발생할 때 사용자에게 의미 있고 실행 가능한 오류 메시지를 제공합니다. 여기에는 사용자가 구성 시 잘못된 입력/빈 입력을 제공하는 경우가 포함됩니다.
  4. shortDescription, description, addOnUrl 링크, supportUrl 링크, OAuth 페이지 (해당하는 경우)에는 맞춤법 및 문법 오류가 없어야 합니다.
  5. shortDescription에는 URL을 포함할 수 없습니다.
  6. getAuthType()에서 제공하는 인증 방법을 사용합니다. getConfig()를 통해 사용자 인증 정보를 요청하지 마세요.
  7. OAuth 클라이언트 인증 절차를 완료합니다. getAuthType()의 인증 방법에 관계없이 모든 커넥터에서 확인이 필요합니다. 확인 프로세스는 커넥터 검토와 다른 프로세스이며 Looker Studio가 아닌 별도의 팀에서 처리합니다. 자세한 내용은 OAuth API 인증 FAQ를 참고하세요. OAuth 클라이언트 인증 프로세스가 완료되지 않으면 커넥터가 거부됩니다.
    • OAuth 확인 프로세스 중에 OAuth 동의 화면 구성의 일부로 커넥터의 필수 OAuth 범위를 추가합니다. 모든 필수 범위를 추가하는 데 실패하면 OAuth 확인 프로세스를 통과할 수 있지만 커넥터에는 여전히 확인되지 않은 앱 화면이 표시됩니다. 이렇게 하면 파트너 커넥터 확인 프로세스가 실패합니다.
      사용자에게 확인되지 않은 앱 화면이 표시되지 않도록 OAuth 확인 절차를 통과한 후 새 계정을 사용하여 커넥터를 승인하고 테스트합니다.
  8. Looker Studio 갤러리 서비스 약관 (제출자)을 준수해야 합니다.

모든 요구사항을 충족했으면 다음 버튼을 클릭하여 커넥터 검토를 요청하세요.

파트너 커넥터 게시