민감한 범위 확인

앱에서 Google API를 사용하여 Google 사용자의 개인 정보에 액세스할 수 있는 권한을 요청하는 경우 데이터를 수집하려면 인증 절차를 완료한 후에 해당 사용자에게 앱을 공개하기 전에 먼저 있습니다.

이 요구사항이 앱에 적용되는지 여부는 크게 다음 두 가지 요소에 따라 결정됩니다.

  1. 액세스하는 사용자 데이터 유형(공개 프로필 정보, 캘린더 항목, 파일에 포함된 파일) 드라이브, 특정 건강/피트니스 데이터 등
  2. 필요한 액세스 수준(읽기 전용, 읽기 및 쓰기 등)

OAuth 2.0을 사용하여 Google 계정으로부터 데이터에 액세스할 수 있는 권한을 받는 경우 scopes라는 문자열을 사용하여 사용자를 대신하여 액세스하려는 데이터 유형을 지정합니다. 만약 앱에서 sensitive 또는 제한됨으로 표시된 경우 계정이 아닌 경우 인증 절차를 완료해야 할 수 있습니다. 앱 사용이 예외에 해당합니다.

민감한 범위의 예로는 Google Calendar에 저장된 일정 읽기, Google 주소록에 새 연락처 저장, YouTube 동영상 삭제가 있습니다. 자세한 내용은 자세히 알아보려면 API 참조 문서를 API에 대해 게시된 관련 승인 가이드 및 앱에서 호출하는 엔드포인트

반드시 필요한 범위와 해당 기능을 제공하는 데 필요한 사용자 데이터에 대한 최소한의 액세스 권한을 제공합니다. 예를 들어 데이터를 읽기만 하는 앱은 더 많은 콘텐츠가 실행될 때 콘텐츠 읽기, 쓰기, 삭제에 대한 액세스 권한을 요청해서는 안 됩니다. API 및 관련 엔드포인트에 사용할 수 있습니다 Google API에서 수신하는 데이터는 API의 정책을 준수하고 앱의 작업 및 개인정보처리방침에서 사용자에게 설명하는 방식으로만 사용해야 합니다.

앱 또는 새로운 범위가 필요한 새 기능의 출시 계획에 인증을 완료하는 데 필요한 시간을 고려해야 합니다. 민감한 범위 인증 절차는 일반적으로 영업일 기준 3~5일이 소요됩니다. 일부 앱은 brand[브랜드] 인증을 민감한 범위 확인 요청의 하위 집합으로 사용하세요.

민감한 범위 이해하기

민감한 범위의 경우 Google 계정에서 액세스 권한을 부여하기 전에 Google의 검토를 거쳐야 합니다. Google Workspace 조직 관리자는 액세스 제한 민감한 범위를 지정하여 조직에서 명시적으로 밝히지 않은 OAuth 클라이언트 ID에 의한 액세스를 방지합니다. 신뢰할 수 있는 항목으로 표시합니다.

범위 사용 이해하기

  • 앱에서 사용 중이거나 사용하려는 범위를 검토합니다. 기존 범위 사용량을 찾으려면 앱의 소스 코드에서 승인 요청과 함께 전송된 범위가 있는지 검토하세요.
  • 요청된 각 범위가 앱 기능의 의도된 작업에 필요한지 확인 기능을 제공하는 데 필요한 최소 권한을 사용합니다. 일반적으로 Google API에는 제품의 에 대한 참조 문서 Google Developer 페이지를 참조하세요. 특정 속성을 지정할 수 있습니다 필요한 범위에 대한 자세한 내용은 앱에서 호출하는 API 엔드포인트에 대한 액세스에 대한 자세한 내용은 해당 참조 문서를 확인하세요. 엔드포인트가 있습니다
  • Google API에서 받은 데이터는 다음 정책을 준수하는 경우에만 사용해야 합니다. 앱의 작업 및 앱에서 사용자에게 나타내는 방식으로 개인정보처리방침을 참조하세요.
  • 각 범위에 대해 자세히 알아보려면 API 문서를 참조하세요. sensitive or restricted 상태.
  • 의 OAuth 동의 화면 구성 범위 페이지를 참조하세요. 지정한 범위는 민감하거나 제한됨으로 그룹화됩니다. 카테고리를 표시하여 추가 인증이 필요한 경우 이를 강조합니다.
  • 통합에 사용되는 데이터와 일치하는 최적의 범위를 찾아 용도를 파악하며 모든 것이 테스트 환경에서 여전히 작동하는지 재확인한 다음 있습니다.
테이블에는 API의 이름, 민감한 범위 중 하나, 범위가 적용되는 항목에 관한 설명이 표시됩니다.
그림 1. 민감한 OAuth 동의 화면 구성 범위 페이지에 표시된 범위

인증 준비 단계

Google API를 사용하여 데이터 액세스를 요청하는 모든 앱은 다음 단계를 따라야 합니다. 브랜드 인증 완료:

  1. 앱이 인증 요구사항 예외 섹션을 참조하세요.
  2. 앱이 관련 API의 브랜드 요구사항을 준수하는지 확인합니다. 있습니다. 예시는 브랜드 가이드라인을 참고하세요. 를 참조하세요.
  3. Google Search Console에서 프로젝트의 승인된 도메인 소유권을 확인합니다. Google 프로젝트에 연결된 계정으로 소유자 또는 편집자
  4. 앱 이름, 지원 이메일, 홈페이지 URI, 개인정보처리방침 URI 등 OAuth 동의 화면의 모든 브랜딩 정보가 앱의 ID를 정확하게 나타내는지 확인합니다.

애플리케이션 홈페이지 요구사항

홈페이지가 다음 요구사항을 충족하는지 확인합니다.

  • 홈페이지는 사이트의 로그인한 사용자뿐만 아니라 누구나 액세스할 수 있어야 합니다.
  • 홈페이지와 검토 중인 앱의 관련성이 명확해야 합니다.
  • Google Play 스토어 또는 Facebook 페이지의 앱 등록정보로 연결되는 링크는 고려되지 않습니다. 사용할 수 있습니다.

애플리케이션 개인정보처리방침 링크 요구사항

앱의 개인정보처리방침이 다음 요구사항을 충족하는지 확인하세요.

  • 개인정보처리방침은 애플리케이션의 OAuth 동의 화면에 링크되어 있으며 홈페이지에는 앱의 기능에 관한 설명뿐 아니라 개인정보처리방침 및 서비스 약관(선택사항)
  • 개인정보처리방침에서는 애플리케이션이 액세스, 사용, Google 사용자 데이터를 저장하거나 공유할 수 없습니다. 게시된 개인정보처리방침에 명시된 관행에 따라 Google 사용자 데이터를 사용해야 합니다.

인증을 위해 앱을 제출하는 방법

프로젝트는 리소스. 프로젝트는 연결된 객체 집합으로 프로젝트 작업을 수행할 수 있는 권한이 있는 Google 계정, 사용 설정된 API 세트 결제, 인증, 모니터링 설정을 직접 관리할 수 있습니다 예를 들어 프로젝트는 하나 이상의 OAuth 클라이언트를 포함하고, 이러한 클라이언트에서 사용할 API를 구성하고, 사용자가 앱 액세스를 승인하기 전에 표시되는 OAuth 동의 화면을 구성할 수 있습니다.

프로덕션에 사용할 준비가 되지 않은 OAuth 클라이언트가 있는 경우 인증을 요청하는 프로젝트에서 삭제하는 것이 좋습니다. 이 작업은

인증을 위해 제출하려면 다음 단계를 따르세요.

  1. 앱이 Google API 서비스 약관 및 Google API 서비스 사용자 데이터 정책
  2. 프로젝트에 연결된 계정의 소유자 및 편집자 역할과 OAuth 동의 화면의 사용자 지원 이메일 및 개발자 연락처 정보 이렇게 하면 팀은 새로운 요구사항에 대한 알림을 받습니다
  3. 페이지로 이동 OAuth
  4. 프로젝트 선택기 버튼을 클릭합니다.

  5. Select from 대화상자가 나타나면 프로젝트를 선택합니다. 계정을 찾을 수 없는 경우 프로젝트 ID를 알고 있는 경우 형식:

    ?project=[PROJECT_ID]

    [PROJECT_ID]를 사용하려는 프로젝트 ID로 바꿉니다.

  6. 앱 수정 버튼을 선택합니다.
  7. OAuth 동의 화면 페이지에 필요한 정보를 입력한 다음 저장 계속 버튼을 클릭합니다.
  8. 범위 추가 또는 삭제 버튼을 사용하여 앱에서 요청한 모든 범위를 선언합니다. Google 로그인에 필요한 초기 범위 집합은 민감하지 않은 범위 섹션을 참조하세요. 추가된 범위는 민감하지 않은 것으로 분류되며 sensitive, or restricted
  9. 앱의 관련 기능과 관련된 문서의 링크를 최대 3개까지 제공합니다.

  10. 이후에 앱에 관해 요청된 추가 정보를 제공하세요. 학습합니다.

    1. Prepare a detailed justification for each requested sensitive scope, as well as an explanation for why a narrower scope isn't sufficient. For example: "My app will use https://www.googleapis.com/auth/calendar to show a user's Google calendar data on the scheduling screen of my app. This lets users manage their schedules through my app and sync the changes with their Google calendar."

    2. Prepare a video that fully demonstrates how a user initiates and grants access to the requested scopes and shows, in detail, the usage of the granted sensitive and restricted scopes in the app. Upload the video to YouTube Studio and set its Visibility as Unlisted. You need to provide a link to the demonstration video in the YouTube link field.

      1. Show the OAuth grant process that users will experience, in English. This includes the consent flow and, if you use Google Sign-In, the sign-in flow.
      2. Show that the OAuth consent screen correctly displays the App Name.
      3. Show that the browser address bar of the OAuth consent screen correctly includes your app's OAuth client ID.
      4. To show how the data will be used, demonstrate the functionality that's enabled by each sensitive scope that you request.
  11. 제공하는 앱 구성에 확인이 필요한 경우 제출할 수 있습니다. 확인할 수 있습니다 필수 입력란을 작성하고 제출을 클릭하여 확인 절차입니다.

앱을 제출한 후에는 Google의 신뢰 및 안전팀에서 해당 사항이 있는 경우 이메일로 고객이 완료해야 하는 추가 정보나 완료해야 하는 단계를 파악할 수 있습니다. 다음에서 이메일 주소를 확인하세요. 개발자 연락처 정보 섹션 및 OAuth 동의의 지원 이메일 추가 정보 요청 화면이 표시됩니다. 프로젝트의 OAuth 동의 화면 페이지에서 답변을 기다리는 동안 검토 절차가 일시중지되었는지 여부 등 프로젝트의 현재 검토 상태를 확인할 수도 있습니다.

인증 요건 예외사항

앱이 다음 섹션에 설명된 시나리오에 사용될 경우 다음을 수행해야 합니다. 검토를 위해 제출할 필요가 없습니다.

개인 용도

한 가지 사용 사례는 개발자가 앱의 유일한 사용자이거나 소수의 사용자만 앱을 사용하는 경우입니다. 모두 여러분에게 개인적으로 알려져 있습니다. 나와 제한된 수의 사용자만 AI의 발전과 함께 인증되지 않은 앱 화면을 열고 개인 계정에 앱 액세스 권한을 부여할 수 있습니다.

개발, 테스트 또는 스테이징에 사용되는 프로젝트 등급

Google OAuth 2.0 정책을 준수하려면 테스트 환경과 프로덕션 환경에 서로 다른 프로젝트를 사용하는 것이 좋습니다. 인증 목적으로만 앱을 제출하는 것이 좋습니다. Google 계정이 있는 모든 사용자에게 앱을 제공하려는 경우에 선택하세요. 따라서 앱이 개발, 테스트 또는 스테이징 단계에 있는 경우 인증이 필요하지 않습니다.

앱이 개발 또는 테스트 단계에 있는 경우 게시 상태 기본 설정인 테스트. 이 설정은 앱이 아직 개발 중이며 테스트 사용자 목록에 추가한 사용자에게 제공됩니다. Google 계정 목록을 관리해야 합니다. 앱 개발 또는 테스트와 관련된 사용자 그룹입니다

테스트 중인 앱을 Google에서 확인하지 않았다는 경고 메시지
그림 2. 테스터 경고 화면

서비스 소유 데이터만

앱이 서비스 계정을 사용하여 자체 데이터에만 액세스하고 어떤 사용자에게도 액세스하지 않는 경우 데이터를 제출하면 인증을 위해 제출할 필요가 없습니다.

서비스 계정이 무엇인지 알아보려면 다음을 참조하세요. 서비스 계정 Google Cloud 문서를 참조하세요. 서비스 계정 사용 방법에 대한 안내는 다음을 참조하세요. 서버 간 OAuth 2.0 사용 애플리케이션입니다.

내부 전용

즉, Google Workspace 또는 Cloud ID의 사용자만 앱을 사용할 수 있습니다. 조직의 역할을 합니다. 프로젝트는 조직에서 소유해야 하며 OAuth 동의 화면이어야 합니다. 사용하려면 내부 사용자 유형이 될 수 있습니다. 이 경우 앱에 조직 관리자의 승인이 필요할 수 있습니다. 대상 자세한 내용은 추가 고려사항을 살펴보세요.

도메인 전체 설치

앱이 Google Workspace 또는 Cloud ID의 사용자만 타겟팅하도록 계획하는 경우 항상 도메인 전체의 도메인 전체 또는 설치된 경우 앱 인증이 필요하지 않습니다. 이는 도메인 전체가 애플리케이션 설치를 통해 도메인 관리자는 타사 및 내부 애플리케이션에 사용자의 데이터입니다. 조직 관리자만 앱에 앱을 추가할 수 있습니다. 허용 목록에 추가해야 합니다.

FAQ에서 앱을 도메인 전체 설치로 설정하는 방법에 대해 알아보기 애플리케이션에 다음과 같은 권한이 있는 사용자가 있습니다. 회사 계정(다른 Google Workspace 도메인의 회사 계정)을 선택합니다.