WebResource
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
WebResource는 확인된 웹사이트 또는 도메인을 나타냅니다.
여기에는 사이트 또는 도메인의 표준 ID, URL 또는 도메인 이름, 소유자 목록이 포함됩니다. 소유자 목록에는 항상 인증된 사용자가 포함됩니다. 웹 리소스에 액세스할 수 있는 사용자는 해당 사이트 또는 도메인의 소유자인 인증된 사용자만 웹 리소스에 액세스할 수 있기 때문입니다.
이 리소스에 대한 메소드 목록은 이 페이지의 하단에 나와 있습니다.
리소스 표현
{
"id": string,
"site": {
"type": string,
"identifier": string
},
"owners": [
string
]
}
| 속성 이름 |
값 |
설명 |
참고 |
id |
string |
이 사이트를 식별하는 데 사용되는 문자열입니다. 이 값은 get, update, delete 작업에 대한 REST URL의 id 부분에 사용해야 합니다. |
|
owners[] |
list |
정확히 일치하는 이 속성의 확인된 모든 직접 소유자의 이메일 주소입니다. 간접 소유자(예: 포함된 도메인의 확인된 소유자)는 이 목록에 포함되지 않습니다. |
|
site |
object |
확인되었거나 확인될 사이트의 주소 및 유형에 대한 컨테이너입니다. |
|
site.identifier |
string |
사이트 식별자로, type 속성의 값에 따라 다른 형식을 취합니다. |
|
site.type |
string |
사이트 유형입니다.
사용 가능한 값은 다음과 같습니다.
<ph type="x-smartling-placeholder"></ph>
- '
ANDROID_APP': identifier을 Android 앱 URL로 설정합니다. Example: "android-app://com.google.android.youtube/"
- '
INET_DOMAIN': identifier을(를) 도메인 이름으로 설정합니다. 예: 'www.example.com', 'example.com' 또는 'subdomain.example.com'
- '
SITE': identifier을 / 기호로 끝나는 사이트 루트의 정규화된 URL로 설정합니다. Examples: "https://www.example.com/" 또는 'https://www.example.com/subsite/'
|
|
메서드
insert 메서드를 사용하여 인증된 사용자의 웹사이트 또는 도메인 소유권을 확인합니다. 인증된 사용자에 대해 이미 확인된 리소스를 검색하거나 수정하려면 get, update, 및 delete 메서드를 사용합니다.
list를 사용하여 인증된 사용자의 확인된 모든 리소스를 볼 수 있으며 getToken으로 인증된 사용자의 사이트에 배치할 토큰을 가져올 수 있습니다.
- 삭제
- 웹사이트 또는 도메인에 대한 사용자의 소유권을 확인합니다.
- get
- 웹사이트 또는 도메인의 최신 데이터를 검색합니다.
- getToken을
- 인증된 사용자가 웹사이트나 도메인에 배치할 인증 토큰을 가져옵니다.
- insert
- 웹사이트 또는 도메인의 소유권을 확인합니다.
- list
- 인증된 사용자의 확인된 웹사이트 및 도메인 목록을 가져옵니다.
- 업데이트
- 웹사이트 또는 도메인의 소유자 목록을 수정합니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eA WebResource represents a verified website or domain and includes its ID, URL/domain, and a list of owners, which always includes the authenticated user.\u003c/p\u003e\n"],["\u003cp\u003eYou can verify ownership, retrieve, update, and delete WebResources using the provided methods.\u003c/p\u003e\n"],["\u003cp\u003eWebResource data includes an ID, owner list, and site information containing the identifier and type (e.g., website, Android app, domain).\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003esite.identifier\u003c/code\u003e can be a domain name, a URL, or an Android app URL depending on the \u003ccode\u003esite.type\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eSeveral methods are available to manage WebResources, including inserting (verifying ownership), retrieving data, updating owner lists, deleting, listing all verified resources, and getting a verification token.\u003c/p\u003e\n"]]],["A WebResource represents a verified website or domain, identified by an `id`, `site` (type and identifier), and a list of `owners`, which always includes the authenticated user. Key actions include using `insert` to verify ownership, `get`, `update`, and `delete` to manage existing resources, `list` to view verified sites, and `getToken` to obtain a verification token. Site `type` can be `ANDROID_APP`, `INET_DOMAIN`, or `SITE`, with corresponding identifier formats.\n"],null,["# WebResource\n\n\u003cbr /\u003e\n\nA WebResource is a representation of a verified website or domain.\n\n\u003cbr /\u003e\n\nIt contains the canonical ID of a site or domain, the URL or domain name, and a list of owners. Note that the owners list always includes the authenticated user, because the only people who can access a WebResource are authenticated users who are owners of that site or domain.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nFor a list of [methods](#methods) for this resource, see the end of this page.\n\nResource representations\n------------------------\n\n\u003cbr /\u003e\n\n```carbon\n{\n \"id\": string,\n \"site\": {\n \"type\": string,\n \"identifier\": string\n },\n \"owners\": [\n string\n ]\n}\n```\n\n| Property name | Value | Description | Notes |\n|-------------------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `id` | `string` | The string used to identify this site. This value should be used in the \u003cvar class=\"apiparam\" translate=\"no\"\u003eid\u003c/var\u003e portion of the REST URL for the [get](/site-verification/v1/webResource/get), [update](/site-verification/v1/webResource/update), and [delete](/site-verification/v1/webResource/delete) operations. | |\n| `owners[]` | `list` | The email addresses of all direct, verified owners of this exact property. Indirect owners---for example verified owners of the containing domain---are not included in this list. | |\n| `site` | `object` | Container for the address and type of a site that is verified or will be verified. | |\n| site.`identifier` | `string` | The site identifier, which takes different forms depending on the value of the `type` property. | |\n| site.`type` | `string` | The site type. \u003cbr /\u003e Acceptable values are: - \"`ANDROID_APP`\": Set `identifier` to an Android app URL. **Example:** \"android-app://com.google.android.youtube/\" - \"`INET_DOMAIN`\": Set `identifier` to a domain name. **Examples:** \"www.example.com\", \"example.com\" or \"subdomain.example.com\" - \"`SITE`\": Set `identifier` to a fully-qualified URL for your site root, ending in a / mark. **Examples:** \"https://www.example.com/\" or \"https://www.example.com/subsite/\" | |\n\nMethods\n-------\n\n\u003cbr /\u003e\n\nUse the [insert](/site-verification/v1/webResource/insert) method to verify the authenticated user's ownership of a website or domain. Use the [get](/site-verification/v1/webResource/get), [update](/site-verification/v1/webResource/update), and [delete](/site-verification/v1/webResource/delete) methods to retrieve or modify a resource that has already been verified for the authenticated user.\n\nYou can see all verified resources for the authenticated user with [list](/site-verification/v1/webResource/list), and you can get a token to place on the authenticated user's site with [getToken](/site-verification/v1/webResource/getToken).\n\n\u003cbr /\u003e\n\n[delete](/site-verification/v1/webResource/delete)\n: Unverifies the user's ownership of a website or domain.\n\n[get](/site-verification/v1/webResource/get)\n: Retrieves the most current data for a website or domain.\n\n[getToken](/site-verification/v1/webResource/getToken)\n: Gets a verification token for the authenticated user to place on a website or domain.\n\n[insert](/site-verification/v1/webResource/insert)\n: Verifies ownership of a website or domain.\n\n[list](/site-verification/v1/webResource/list)\n: Gets the list of the authenticated user's verified websites and domains.\n\n[update](/site-verification/v1/webResource/update)\n: Modifies the list of owners for a website or domain."]]
