파트너 커넥터 요구사항

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

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 속성을 채웁니다. 자세한 내용은 매니페스트 참조의 소스를 참고하세요.
    • 데이터 등록처 저장소에서 기존 소스 목록을 확인할 수 있습니다. 연결하려는 소스가 저장소에 없는 경우 데이터 레지스트리 저장소에 pull 요청을 보내 소스를 추가합니다. 매니페스트의 소스가 저장소에 없으면 커넥터가 검토 프로세스를 통과하지 못합니다.
    • 갤러리의 검색 기능을 위해 색인이 생성되는 커넥터의 추가 메타데이터입니다. 사용자가 갤러리에서 특정 소스를 검색하면 커넥터가 검색 결과에 표시됩니다.
  6. shortDescription, authType, feeType, privacyPolicyUrl, termsOfServiceUrl의 값을 제공합니다.
  7. name 은 커넥터의 목적을 직접 나타내야 합니다. 명확한 이름을 사용하면 사용자가 커넥터가 자신의 요구사항을 충족하는지 판단하는 데 도움이 됩니다. 사용자는 커넥터를 보고 있다는 것을 이미 알고 있으므로 이름에 커넥터라는 단어를 사용하지 마세요.
    • 커넥터의 위치를 변경하거나 눈길을 끌기 위해 특수문자나 보이지 않는 문자를 포함하지 마세요.
  8. 매니페스트의 어느 곳에서도 데이터 스튜디오의 약어 이름 (예: GDS, DS 등)을 사용하지 마세요.
  9. 그림 이모티콘은 매니페스트 필드(description, shortDescription, name 등)에 허용되지 않습니다. 일반적으로 커넥터에 주의를 끌기 위해 특수 문자나 보이지 않는 문자를 포함하지 마세요.
  10. 커넥터에 고정 스키마가 있는 경우 커넥터의 보고서 템플릿을 만들고 매니페스트에 추가합니다. 보고서에 대해 링크로 공유를 사용 설정합니다.

urlFetchWhitelist

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

oauthScopes

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

커넥터

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

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

파트너 커넥터 게시