CSS API를 사용하는 방법은 다음과 같습니다.
권한
CSS API를 사용하려면 Google Cloud와 CSS 센터 두 곳에서 권한을 구성해야 합니다.
Google Cloud IAM:
- Google Cloud 콘솔에서 서비스 계정을 만듭니다. Content API와 유사한 안내에 따라 JSON 사용자 인증 정보 파일을 만들고 다운로드합니다. 이 단계에서는 서비스 계정을 유효한 Google Cloud 엔티티로 인증합니다.
- 직접 REST 액세스 또는 Google API 클라이언트 라이브러리를 사용하는 경우 Google Cloud 콘솔에서 생성된 API 키도 필요합니다.
CSS Center:
- 서비스 계정 이메일 주소 (예:
your-service-account-name@your-project-id.iam.gserviceaccount.com) CSS Center 계정에 관리 액세스 권한이 있는 사용자로 추가되어야 합니다. 이 단계를 통해 서비스 계정이 CSS 센터 데이터에 액세스하고 이를 관리할 수 있습니다. - CSS 그룹 수준 (모든 도메인에 대한 액세스) 또는 특정 CSS 도메인 계정에 액세스 권한을 부여할 수 있습니다. API 액세스의 경우 CSS 그룹 수준에서 액세스 권한을 부여하는 것이 일반적입니다.
- 서비스 계정을 추가하려면 다음 단계를 따르세요.
- 관리자 사용자로 CSS Center에 로그인합니다.
- 계정 액세스 (기어 아이콘 ⚙️ 아래)로 이동합니다.
- + 사용자 추가를 클릭하고 서비스 계정 이메일을 입력합니다.
- 액세스 수준을 관리자로 설정합니다.
- 권한이 전파되는 데 최대 30분이 걸릴 수 있습니다. 권한 오류가 발생하면 나중에 다시 시도해 보세요.
- 서비스 계정 이메일 주소 (예:
인증 범위:
CSS API에 필요한 OAuth 2.0 범위는 다음과 같습니다.
https://www.googleapis.com/auth/content
인증 시 애플리케이션이 이 범위를 요청하는지 확인합니다.
CSS API 사용 설정
CSS API를 사용하려면 Google Cloud 프로젝트에서 CSS API를 사용 설정해야 합니다. 라이브러리는 https://console.cloud.google.com/apis/library/css.googleapis.com에서 확인할 수 있습니다.
프로그래밍 시작
CSS API에는 시작하는 데 도움이 되는 코드 샘플과 클라이언트 라이브러리가 있습니다. 권장사항 페이지도 있습니다.
요청 보내기
다음 형식으로 URL에 요청을 전송합니다.
https://css.googleapis.com/{version}/{resource name}:{method}…
여기서 {resource name}은 호출이 영향을 미치는 리소스의 이름입니다.
예를 들어 gRPC로 리소스를 삭제하는 방법은 다음과 같습니다.
https://css.googleapis.com/v1/{resource name}:delete
REST를 사용하여 리소스를 삭제하는 방법은 다음과 같습니다.
DELETE https://css.googleapis.com/v1/{resource name}
특정 서비스에 관한 자세한 내용은 CSS API 참조 문서를 참고하세요.
gRPC 또는 REST 사용
CSS API는 gRPC 및 REST를 지원합니다. CSS API 호출을 수행하는 두 가지 방법은 다음과 같습니다.
| gRPC (권장) | REST |
|---|---|
|
|
도움말 보기
Google 담당자에게 문의하여 지원을 받거나 의견 양식을 사용하여 문제를 신고하세요.
문제가 발생한 경우 추가 의견을 제공하는 방법은 다음과 같습니다.
의견 보내기
의견을 제공하려면 다음 중 하나를 제출하세요.
- API 기능: 의견 양식 제출
- 문서: 페이지 내 썸 평점 및 의견 보내기 버튼을 사용합니다.
- 샘플 및 라이브러리: GitHub에서 새 문제 버튼을 사용합니다.
각 작업을 구현한 후 일반적인 의견을 제공하려면 의견 양식을 사용하세요.