이 문서에서는 Google Site Verification API를 사용하는 방법을 설명합니다.
API 호출
요청 형식
지원되는 사이트 확인 작업은 대부분 Google Site Verification API 작업에 설명된 대로 REST HTTP 동사 (GET
, POST
, PUT
, DELETE
)에 직접 매핑됩니다.
Google Site Verification API URI의 구체적인 형식은 다음과 같습니다.
https://www.googleapis.com/siteVerification/v1/webResource/resourceID?parameters
여기서 resourceID
는 웹 리소스의 식별자이고, parameters
은 쿼리에 적용할 매개변수입니다. 사용하는 실제 매개변수는 수행하는 작업에 따라 다릅니다. 또한 OAuth 2.0을 사용하는 경우 이러한 매개변수에 access_token
를 설정해야 합니다.
목록 쿼리에는 resourceID가 필요하지 않으므로 형식은 다음과 같습니다.
https://www.googleapis.com/siteVerification/v1/webResource?parameters
자체 고유 URI를 사용하여 getToken 작업을 호출할 수 있습니다. getToken 호출 형식은 다음과 같습니다.
https://www.googleapis.com/siteVerification/v1/token?parameters
데이터 형식
Google Site Verification API는 JSON 형식으로 데이터를 반환합니다.
JSON(JavaScript Object Notation)은 특정 언어에 의존하지 않는 일반적인 데이터 형식으로, 임의의 데이터 구조를 간단한 텍스트로 표현할 수 있습니다. 자세한 내용은 json.org를 참조하세요.
작업 요약
다음 표에 설명된 대로 Google Site Verification API의 컬렉션 및 리소스에서 서로 다른 6개의 메서드를 호출할 수 있습니다. API URL은 https://www.googleapis.com/siteVerification/v1
을 기준으로 합니다.
작업 | 설명 | URL 및 구문 |
---|---|---|
list | 인증된 사용자의 컬렉션 내의 모든 리소스를 나열합니다. |
목록 요청 예를 참고하세요. |
삽입 | 사이트 또는 도메인을 확인합니다. 성공하면 사용자의 컬렉션에 새 웹 리소스가 삽입됩니다. 요청 본문: 웹 리소스를 확인하세요. 쿼리 매개변수: |
삽입 요청 예를 참고하세요. |
get | 특정 웹 리소스의 최신 데이터를 가져옵니다. |
get 요청 예를 참고하세요. |
업데이트 | 특정 리소스의 소유자 목록을 수정합니다. 요청 본문: 웹 리소스를 확인하세요. 참고:
|
업데이트 요청 예를 참고하세요. |
delete | 사용자의 컬렉션에서 리소스를 삭제합니다 (사이트가 사용자의 소유인지 확인하지 않음).
|
삭제 요청 예를 참고하세요. |
getToken | 인증된 사용자의 웹사이트에 배치할 확인 토큰을 가져옵니다. 요청 본문:
|
getToken 요청 예시를 참조하세요. |
API 호출 예
이 섹션에서는 개발자가 자체 테스트 데이터로 API를 처음 시도할 때와 마찬가지로 인증된 사용자라고 가정합니다.
새 사이트 확인
사이트를 인증하려면 다음 단계를 따르세요.
- 먼저 getToken을 호출하여 인증 토큰을 요청합니다.
- 선택한 방법에 따라 토큰을 사이트에 배치합니다.
- 삽입 작업을 사용하여 Google에 사이트가 본인 소유임을 확인해 달라고 요청합니다.
getToken(승인 필요)
POST https://www.googleapis.com/siteVerification/v1/token?access_token=
oauth2-token
요청:
POST https://www.googleapis.com/siteVerification/v1/token?access_token=oauth2-token
Content-Type: application/json
{
"verificationMethod": "FILE",
"site": {
"identifier": "http://www.example.com",
"type": "SITE"
}
}
응답:
{ "token": "google12cfc68677988bb4.html", "method": "FILE" }
삽입 (승인 필요)
POST https://www.googleapis.com/siteVerification/v1/webResource?verificationMethod=FILE&access_token=
oauth2-token
요청:
POST https://www.googleapis.com/siteVerification/v1/webResource?verificationMethod=FILE&access_token=oauth2-token
Content-Type: application/json
{
"site": {
"identifier": "http://www.example.com",
"type": "SITE"
}
}
응답:
{ "owners": [ "myself@example.com", ], "id": "http%3A%2F%2Fwww.example.com%2F", "site": { "identifier": "http://www.example.com/", "type": "SITE" } }
확인된 웹 리소스에 대한 정보 검색
list를 호출하여 확인된 사이트 및 도메인의 전체 목록을 검색할 수 있습니다. get을 호출하면 단일 웹 리소스에 대한 정보를 검색할 수 있습니다.
목록 (승인 필요)
GET https://www.googleapis.com/siteVerification/v1/webResource?access_token=
oauth2-token
요청:
GET https://www.googleapis.com/siteVerification/v1/webResource?access_token=oauth2-token
응답:
{ "items": [ { "owners": [ "myself@example.com", ], "id": "http%3A%2F%2Fwww.example.com%2F", "site": { "identifier": "http://www.example.com/site1", "type": "SITE" } }, { "owners": [ "myself@example.com", ], "id": "http%3A%2F%2Fwww.example.com%2F", "site": { "identifier": "http://www.example.com/site2", "type": "SITE" } } ] }
가져오기(승인 필요)
GET https://www.googleapis.com/siteVerification/v1/webResource/http%3A%2F%2Fwww.example.com%2F?access_token=
oauth2-token
요청:
GET https://www.googleapis.com/siteVerification/v1/webResource/http%3A%2F%2Fwww.example.com%2F?access_token=oauth2-token
응답:
{ "owners": [ "myself@example.com", ], "id": "http%3A%2F%2Fwww.example.com%2F", "site": { "identifier": "http://www.example.com/", "type": "SITE" } }
인증 정보 수정
update를 호출하여 소유권을 위임하고 취소할 수 있습니다. delete를 호출하여 소유권을 직접 삭제할 수 있습니다.
업데이트(승인 필요)
PUT https://www.googleapis.com/siteVerification/v1/webResource/http%3A%2F%2Fwww.example.com%2F?access_token=
oauth2-token
요청:
PUT https://www.googleapis.com/siteVerification/v1/webResource/http%3A%2F%2Fwww.example.com%2F?access_token=oauth2-token
Content-Type: application/json
{
"owners": [
"myself@example.com",
"another@example.com",
],
"id": "http%3A%2F%2Fwww.example.com%2F",
"site": {
"identifier": "http://www.example.com",
"type": "SITE"
}
}
응답:
{ "owners": [ "myself@example.com", "another@example.com", ], "id": "http%3A%2F%2Fwww.example.com%2F", "site": { "identifier": "http://www.example.com/", "type": "SITE" } }
삭제(승인 필요)
DELETE https://www.googleapis.com/siteVerification/v1/webResource/http%3A%2F%2Fwww.example.com%2F?access_token=
oauth2-token
요청:
DELETE https://www.googleapis.com/siteVerification/v1/webResource/http%3A%2F%2Fwww.example.com%2F?access_token=oauth2-token
응답:
성공을 나타내는 HTTP 204 (콘텐츠 없음) 상태 코드