WebResource
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
WebResource نمایشی از یک وب سایت یا دامنه تایید شده است.
این شامل شناسه متعارف یک سایت یا دامنه، آدرس اینترنتی یا نام دامنه و فهرستی از مالکان است. توجه داشته باشید که لیست مالکان همیشه شامل کاربر تأیید شده است، زیرا تنها افرادی که می توانند به یک WebResource دسترسی داشته باشند، کاربران احراز هویت شده ای هستند که مالک آن سایت یا دامنه هستند.
برای لیست روش های این منبع، انتهای این صفحه را ببینید.
بازنمایی منابع
{
"id": string,
"site": {
"type": string,
"identifier": string
},
"owners": [
string
]
}| نام ملک | ارزش | توضیحات | یادداشت ها |
|---|
id | string | رشته ای که برای شناسایی این سایت استفاده می شود. این مقدار باید در بخش id URL REST برای عملیات دریافت ، به‌روزرسانی و حذف استفاده شود. | |
owners[] | list | آدرس‌های ایمیل همه صاحبان مستقیم و تأیید شده این ملک دقیقاً. مالکان غیرمستقیم - برای مثال مالکان تأیید شده دامنه حاوی - در این لیست گنجانده نشده اند. | |
site | object | کانتینری برای آدرس و نوع سایتی که تایید شده یا تایید خواهد شد. | |
site. identifier | string | شناسه سایت که بسته به مقدار خاصیت type ، اشکال مختلفی دارد. | |
site. type | string | نوع سایت
مقادیر قابل قبول عبارتند از:- "
ANDROID_APP ": identifier روی URL برنامه Android تنظیم کنید. مثال: "android-app://com.google.android.youtube/" - "
INET_DOMAIN ": identifier روی نام دامنه تنظیم کنید. مثال‌ها: «www.example.com»، «example.com» یا «subdomain.example.com» - "
SITE ": identifier را روی یک URL کاملاً واجد شرایط برای ریشه سایت خود تنظیم کنید که به علامت / ختم می شود. مثال‌ها: "https://www.example.com/" یا "https://www.example.com/subsite/"
| |
روش ها
از روش درج برای تأیید مالکیت کاربر تأیید شده بر وب سایت یا دامنه استفاده کنید. از روش‌های دریافت ، به‌روزرسانی و حذف برای بازیابی یا اصلاح منبعی استفاده کنید که قبلاً برای کاربر تأیید شده تأیید شده است.
شما می توانید تمام منابع تایید شده برای کاربر احراز هویت شده را با لیست مشاهده کنید، و می توانید یک نشانه برای قرار دادن در سایت کاربر احراز هویت شده با getToken دریافت کنید.
- حذف کنید
- مالکیت کاربر بر یک وب سایت یا دامنه را تأیید نمی کند.
- دریافت کنید
- جدیدترین داده ها را برای یک وب سایت یا دامنه بازیابی می کند.
- getToken
- یک رمز تأیید را برای کاربر تأیید شده دریافت می کند تا در یک وب سایت یا دامنه قرار دهد.
- درج کنید
- مالکیت یک وب سایت یا دامنه را تأیید می کند.
- فهرست
- لیستی از وب سایت ها و دامنه های تأیید شده کاربر تأیید شده را دریافت می کند.
- به روز رسانی کنید
- لیست مالکان یک وب سایت یا دامنه را تغییر می دهد.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\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."]]
