애플리케이션에서 비공개 데이터를 요청하면 해당 데이터에 액세스할 수 있는 인증된 사용자가 요청을 승인해야 합니다.
애플리케이션에서 Display & Video 360 API로 전송하는 모든 요청에는 승인 토큰이 포함되어야 합니다. Google은 이 토큰을 사용하여 애플리케이션을 식별합니다.
승인 프로토콜 정보
요청을 승인하려면 애플리케이션에서 OAuth 2.0을 사용해야 합니다. 다른 승인 프로토콜은 지원되지 않습니다. 애플리케이션에서 Google 계정으로 로그인을 사용하는 경우, 승인의 일부 절차는 자동으로 처리됩니다.
OAuth 2.0을 사용하여 요청 승인하기
Display & Video 360 API에 대한 모든 요청은 인증된 사용자의 승인을 받아야 합니다.
OAuth 2.0의 세부적인 승인 절차('흐름')는 제작 중인 애플리케이션 종류에 따라 약간씩 다릅니다. 다음의 일반적인 과정은 모든 애플리케이션 유형에 적용됩니다.
- 애플리케이션을 만들 때 Google API 콘솔을 사용하여 애플리케이션을 등록합니다. 이렇게 하면 Google에서 클라이언트 ID 및 클라이언트 보안 비밀과 같이 나중에 필요한 정보를 제공합니다.
- Google API 콘솔에서 Display & Video 360 API를 활성화합니다. API 콘솔의 목록에 이 API가 없다면 이 단계를 건너뜁니다.
- 애플리케이션에서 사용자 데이터에 액세스해야 하는 경우 Google에 특정 액세스 범위를 요청합니다.
- Google에서 사용자에게 애플리케이션이 일부 데이터를 요청하도록 승인할 것인지 물어보는 동의 화면을 표시합니다.
- 사용자가 승인하면 Google에서 애플리케이션에 제한 시간이 있는 액세스 토큰을 제공합니다.
- 애플리케이션에서 액세스 토큰을 첨부하여 사용자 데이터를 요청합니다.
- Google에서 요청과 토큰이 유효하다고 판단하면 요청된 데이터를 반환합니다.
일부 흐름에는 새로운 액세스 토큰을 얻기 위해 갱신 토큰을 사용하는 등의 추가 단계가 포함됩니다. 다양한 유형의 애플리케이션에 적용되는 흐름을 자세히 알아보려면 Google의 OAuth 2.0 문서를 참조하세요.
다음은 Display & Video 360 API의 OAuth 2.0 범위 정보입니다.
| 범위 | 의미 |
|---|---|
https://www.googleapis.com/auth/display-video |
읽기/쓰기 액세스 |
https://www.googleapis.com/auth/display-video-user-management |
users 서비스에 대한 읽기/쓰기 액세스 권한입니다. 서비스 계정 사용자만 사용할 수 있습니다.
|
OAuth 2.0을 사용하여 액세스를 요청하려면 애플리케이션에 범위 정보와 함께 애플리케이션 등록 시 Google에서 제공하는 정보(예: 클라이언트 ID, 클라이언트 보안 비밀)가 필요합니다.
팁: Google API 클라이언트 라이브러리가 사용자를 대신하여 일부 승인 과정을 처리할 수 있습니다. 이러한 라이브러리는 다양한 프로그래밍 언어로 제공됩니다. 자세한 내용은 라이브러리 및 샘플 페이지를 참조하세요.
사용자 권한
Display & Video 360 API를 사용하려면 Google 계정을 인증하는 사용자가 관련 파트너 또는 광고주에 액세스할 수 있는 Display & Video 360 사용자여야 합니다.
관련 파트너 또는 광고주가 다음 작업을 하려면 Display & Video 360 사용자에게 다음 사용자 역할 중 하나가 있어야 합니다.
- 읽기 전용:
get또는list호출을 사용하여 리소스를 가져옵니다(user리소스 제외). - 표준: 리소스를 검색, 생성, 업데이트합니다. 동일한 파트너 또는 광고주에 대한 권한이 있는
user리소스를 검색합니다. - 관리자: 리소스를 검색, 생성, 업데이트합니다. 관리하는 파트너 또는 광고주를 위해
user리소스를 검색, 만들고 액세스 권한을 부여합니다.