WebResource
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمثّل WebResource موقعًا إلكترونيًا أو نطاقًا تم إثبات ملكيتهما.
ويحتوي على المعرّف الأساسي لموقع إلكتروني أو نطاق، وعنوان URL أو اسم النطاق، وقائمة بالمالكين. لاحظ أن قائمة المالكين تتضمن دائمًا المستخدم الذي تمت مصادقته، وذلك لأن الأشخاص الذين يمكنهم الوصول إلى WebResource فقط هم المستخدمون الذين تمت مصادقتهم والذين يملكون هذا الموقع أو النطاق.
للحصول على قائمة من الطرق لهذا المورد، راجِع نهاية هذه الصفحة.
تمثيلات الموارد
{
"id": string,
"site": {
"type": string,
"identifier": string
},
"owners": [
string
]
}
اسم الموقع |
القيمة |
الوصف |
ملاحظات |
id |
string |
السلسلة المستخدمة لتعريف هذا الموقع الإلكتروني. يجب استخدام هذه القيمة في الجزء id من عنوان URL REST لعمليات get وupdate وdelete. |
|
owners[] |
list |
عناوين البريد الإلكتروني لجميع المالكين المباشرين الذين تم إثبات ملكيتهم لهذا الموقع الإلكتروني تحديدًا. ولا يتم تضمين المالكين غير المباشرين، على سبيل المثال المالكون المعتمَدون للنطاق الذي يتضمن المحتوى، في هذه القائمة. |
|
site |
object |
حاوية لعنوان ونوع الموقع الإلكتروني الذي تم إثبات ملكيته أو الموقع الإلكتروني الذي سيتم إثبات ملكيته. |
|
site.identifier |
string |
معرّف الموقع الإلكتروني، والذي يتخذ أشكالاً مختلفة بناءً على قيمة السمة type |
|
site.type |
string |
نوع الموقع الإلكتروني.
في ما يلي القيم المقبولة:
- "
ANDROID_APP ": اضبط identifier على عنوان URL لتطبيق Android. 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/"
|
|
الطُرق
استخدِم الطريقة إدراج لإثبات ملكية المستخدم الذي تمت مصادقته لموقع إلكتروني أو نطاق. استخدِم طرق الحصول, تعديل, , حذف لاسترداد أو تعديل مورد تم إثبات ملكيته من قبل للمستخدم الذي تمت مصادقته.
يمكنك الاطّلاع على جميع الموارد التي تم إثبات ملكيتها للمستخدم الذي تمت المصادقة عليه من خلال list، كما يمكنك الحصول على رمز مميّز لوضعه على الموقع الإلكتروني للمستخدم الذي تمت المصادقة عليه باستخدام getToken.
- حذف
- إثبات ملكية المستخدم لموقع إلكتروني أو نطاق
- الحصول على
- استرداد أحدث البيانات لموقع إلكتروني أو نطاق
- getToken
- الحصول على رمز تحقُّق للمستخدم الذي تمت مصادقته ليضعه على موقع إلكتروني أو نطاق
- إدراج
- إثبات ملكية موقع إلكتروني أو نطاق
- list
- الحصول على قائمة المواقع الإلكترونية والنطاقات الخاصة بالمستخدم الذي تمت المصادقة عليه
- تعديل
- يعدِّل قائمة مالكي موقع إلكتروني أو نطاق.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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."]]