외부 사용자를 위해 Data Manager API의 사용자 인증 정보를 요청하는 애플리케이션을 실행하기 전에 Google Cloud 프로젝트에서 Google OAuth 앱 인증을 거쳐야 합니다.
이 가이드에서는 개발 중 권장되는 잠재고객 구성 전환과 Google OAuth 앱 인증을 완료하는 단계를 설명합니다.
앱 잠재고객 단계
개발 단계에 따라 Google Cloud 콘솔의 잠재고객 페이지를 다양한 사용자 유형 및 게시 상태 설정으로 구성합니다. 초기 테스트에서 프로덕션 출시로 원활하게 전환하려면 다음 단계를 따르세요.
1단계: 초기 개발 (테스트)
개발을 시작하고 기본 API 요청을 테스트하는 경우:
게시 상태: 테스트로 설정합니다.
사용자 유형:
Google Cloud 프로젝트가 Google Workspace 조직에 속하고 조직의 사용자만 앱을 사용하는 경우 내부를 선택합니다.
그렇지 않으면 외부를 선택합니다.
테스트 사용자: 사용자 유형을 외부로 설정한 경우 사용자 추가를 클릭하여 사용자 인증 정보를 생성하는 데 사용하는 Google 계정을 수동으로 추가합니다. 나열된 Google 계정만 앱을 승인할 수 있으며 테스트 한도 및 토큰 만료 규칙이 적용됩니다.
테스트 중에는 인증이 필요하지 않습니다. 외부를 사용하는 경우 테스트 사용자는 동의 화면으로 진행하기 전에 확인되지 않은 앱에 대한 테스트 액세스 권한이 있음을 확인하는 경고 화면을 보게 됩니다.
2단계: 출시 임박 (인증 제출)
통합이 완료되고 사용자 인터페이스가 빌드되었으며 다음 달 내에 출시할 계획인 경우:
시청자층 페이지 설정을 업데이트합니다.
게시 상태: 프로덕션으로 전환합니다.
사용자 유형: 앱이 광고주 클라이언트와 같이 조직 외부의 고객에게 서비스를 제공하는 경우 외부로 설정합니다.
인증을 위해 앱을 제출합니다. Google OAuth 앱 인증 절차는 몇 주 정도 걸릴 수 있으므로 UI가 준비되면 최대한 빨리 제출하세요.
앱 인증 요구사항
인증 센터에서 인증을 위해 앱을 제출하려면 Google 인증 플랫폼 설정을 구성하고 필요한 인증 자료를 준비하세요.
브랜딩 및 개인정보처리방침
Google Cloud 콘솔의 브랜딩 페이지에서 제출하기 전에 다음 세부정보를 확인합니다.
애플리케이션 홈페이지: 홈페이지는 공개적으로 액세스할 수 있어야 하며 애플리케이션의 개인정보처리방침에 대한 링크가 표시되어야 합니다.
개인정보처리방침 링크: 브랜딩 페이지에 구성된 개인정보처리방침 URL은 애플리케이션 홈페이지에 연결된 개인정보처리방침 URL과 일치해야 합니다.
인증 범위
데이터 액세스 페이지에서 애플리케이션에 필요한 범위만 요청합니다. Data Manager API는 민감한 범위를 사용합니다.
https://www.googleapis.com/auth/datamanager(기본 범위)https://www.googleapis.com/auth/datamanager.partnerlink(파트너 링크)
확인 제출 시 애플리케이션에 요청된 범위에 대한 액세스 권한이 필요한 이유를 자세히 설명하세요.
연락처 정보
Google OAuth 인증팀은 Google Cloud 프로젝트에 구성된 프로젝트 소유자 및 프로젝트 편집자에게 모든 커뮤니케이션을 전송합니다. 정보 요청을 놓치지 않도록 Google Cloud 콘솔에서 이러한 연락처 정보를 최신 상태로 유지하세요.
확인팀에서 후속 질문을 보내거나 업데이트 (예: 시연 동영상 또는 동의 화면 설정 변경)를 요청하는 경우 응답할 때까지 검토가 일시중지됩니다. 제출물이 업데이트 없이 몇 주 이상 대기 중인 경우 모든 프로젝트 소유자 및 프로젝트 편집자의 이메일 받은편지함 (스팸 및 정크 폴더 포함)을 확인하세요.
데모 동영상
애플리케이션에서 요청된 범위를 사용하는 방법을 보여주는 공개적으로 액세스 가능한 데모 동영상 (예: 일부 공개 YouTube 동영상 또는 공개 Google Drive 링크)의 링크를 제공합니다.
동영상이 다음 Data Manager API 검사를 포함하여 모든 앱 기능 데모 동영상 요구사항을 충족하는지 확인합니다.
엔드 투 엔드 사용자 여정 및 OAuth 권한 부여: 사용자가 로그인을 시작하거나 OAuth 권한 부여 흐름을 완료하여 승인하는 것부터 시작하여 애플리케이션의 전체 사용자 여정을 보여줍니다.
일치하는 앱 ID: 동영상에 표시된 애플리케이션 이름, 로고, 브랜딩이 Google Cloud 콘솔의 브랜딩 페이지 구성과 일치하는지 확인합니다.
영어로 된 OAuth 동의 화면 작성: 왼쪽 하단의 언어 선택기가 영어로 설정된 전체 OAuth 동의 화면을 표시하고 화면에 앱에서 요청하는 정확한 Data Manager API 범위가 표시되는지 확인합니다.
앱 UI의 범위 사용: 요청된 범위를 사용하는 앱 기능을 보여줍니다 (예: 파트너 링크 만들기, 잠재고객 목록 만들기, 애플리케이션 UI에서 데이터 수집 구성).
3단계: 출시 준비 완료 (확인됨)
Google OAuth 인증팀에서 앱 인증 요청을 승인했다고 알리면 별도의 조치가 필요하지 않습니다. 이제 앱이 확인되었으며 외부 사용자는 확인되지 않은 앱 경고 화면 없이 앱을 승인할 수 있습니다.