Google Ads API용 OAuth2 내부 기능

클라이언트 라이브러리가 아래에서 다루는 세부 사항을 자동으로 처리하므로 이면에서 무슨 일이 벌어지고 있는지에 관심이 있는 경우에만 장면 또는 Google의 클라이언트 라이브러리 중 하나를 사용하지 않는 경우에 발생합니다.

이 섹션은 이미 익숙한 고급 사용자를 대상으로 합니다. OAuth 2.0 사양 사용 Google API에서 OAuth2를 사용하는 방법을 알아야 합니다.

API에서의 인증에 대해 자세히 알아보고 싶으신가요?

동영상 라이브러리: 인증 및 승인

범위

단일 액세스 토큰은 여러 API에 다양한 수준의 액세스 권한을 부여할 수 있습니다. 가 scope이라는 변수 매개변수는 리소스와 작업 집합을 제어합니다. 포드를 설정할 수 있습니다 액세스 토큰을 요청하는 동안 앱은 scope 매개변수에 하나 이상의 값을 전송합니다.

Google Ads API의 범위는 다음과 같습니다.

https://www.googleapis.com/auth/adwords

오프라인 액세스

Google Ads API 클라이언트 앱에서는 오프라인 액세스를 요청하는 경우가 많습니다. 예를 들어 사용자가 실제로 온라인 상태가 아닐 때 앱에서 일괄 작업을 실행하려고 할 수 있음 도움이 될 수 있습니다

특정 유형의 웹 앱에 대해 오프라인 액세스를 요청하려면 access_type 매개변수를 offline로 설정합니다. 자세한 내용은 Google의 OAuth2 가이드

데스크톱 앱 유형의 경우 오프라인 액세스가 기본적으로 사용 설정되어 있습니다. 명시적으로 요청할 필요가 없습니다

요청 헤더

gRPC 헤더

gRPC API를 사용할 때 각 요청에 액세스 토큰을 포함합니다. 이 해당 채널의 모든 요청에 사용할 CredentialChannel로 설정합니다. 다음과 같은 작업을 할 수 있습니다. 각 호출에 대해 맞춤설정된 사용자 인증 정보를 전송합니다. gRPC 자세한 내용은 승인 가이드를 참조하세요. 자세히 알아보세요.

REST 헤더

REST API를 사용할 때 HTTP 헤더를 통해 액세스 토큰 전달 Authorization 다음은 HTTP 요청의 예입니다.

GET /v17/customers/123456789 HTTP/2
Host: googleads.googleapis.com
User-Agent: INSERT_USER_AGENT
Accept: */*
Authorization: Bearer INSERT_ACCESS_TOKEN
developer-token: INSERT_DEVELOPER_TOKEN

액세스 및 새로고침 토큰

대부분의 경우 나중에 사용할 수 있도록 갱신 토큰을 안전하게 저장해야 합니다. 액세스 및 갱신 토큰을 요청하는 방법에 대해 자세히 알아보려면 애플리케이션 유형별 가이드를 참조하세요.

갱신 토큰 만료

갱신 토큰 만료에 대한 자세한 내용은 Google Identity Platform OAuth 문서

액세스 토큰 만료

액세스 토큰에는 만료 시간이 있습니다. expires_in 값) 이는 토큰이 더 이상 유효하지 않은 것입니다. 갱신 토큰을 사용하여 액세스할 수 없게 됩니다 기본적으로 클라이언트 라이브러리는 자동으로 갱신할 수 없습니다.