WebResource: update
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
需要授權
修改網站或網域的擁有者清單。
立即試用。
「網站驗證」系統會視需要新增或移除擁有者,以符合更新資源提供的擁有者清單。如果更新後的擁有者清單與目前擁有者清單相同,則不會進行任何變更。
從清單中移除擁有者前,請先確認與該擁有者相關聯的所有驗證權杖都已移除。否則,呼叫 update 會導致 HTTP 400 Bad Request
錯誤。
注意:你無法使用這個方法取消已驗證使用者的網站擁有權。請改用 delete 方法。
要求
HTTP 要求
PUT https://www.googleapis.com/siteVerification/v1/webResource/id
參數
參數名稱 |
值 |
說明 |
路徑參數 |
id |
string |
已驗證網站或網域的 ID。
|
授權
此要求需要獲得下列範圍的授權 (進一步瞭解驗證和授權)。
範圍 |
https://www.googleapis.com/auth/siteverification |
要求主體
在要求主體中,提供 WebResource 資源。
試試看!
使用下方的 APIs Explorer,針對即時資料呼叫這個方法,看看會有什麼結果。
您也可以改用
獨立式
Explorer。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間:2025-07-25 (世界標準時間)。"],[[["\u003cp\u003eThis method modifies the owner list of a website or domain, updating it to match the provided list.\u003c/p\u003e\n"],["\u003cp\u003eRemoving an owner requires prior removal of their associated verification tokens to avoid errors.\u003c/p\u003e\n"],["\u003cp\u003eUnverifying your own site ownership must be done through a separate method, not this one.\u003c/p\u003e\n"],["\u003cp\u003eThe request needs authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/siteverification\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eUpon success, the method returns the updated WebResource resource.\u003c/p\u003e\n"]]],["This action updates a website or domain's owner list. The system will add or remove owners to match the provided list, but no changes occur if the list is unchanged. Before removing an owner, all associated verification tokens must be deleted, or a `400 Bad Request` error will occur. You cannot unverify the authenticated user via this method; use the `delete` method instead. This action is a `PUT` request and requires authorization. It updates the list by the provided `id` in the URL path.\n"],null,["# WebResource: update\n\n**Requires [authorization](#auth)**\n\nModifies the list of owners for a website or domain.\n[Try it now](#try-it).\n\nThe Site Verification system adds or removes owners as needed to match the owner list provided in the updated resource. No changes are made if the updated owner list is identical to the current owner list. \n\nBefore removing an owner from the list, ensure that all verification tokens associated with that owner have been removed. Otherwise, calling [update](#method_siteVerification.webResource.update) results in an HTTP `400 Bad Request` error. \n\nNote: You cannot use this method to unverify the authenticated user's ownership of a site. Use the [delete](#method_siteVerification.webResource.delete) method instead.\n\nRequest\n-------\n\n### HTTP request\n\n```\nPUT https://www.googleapis.com/siteVerification/v1/webResource/id\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|----------|--------------------------------------|\n| **Path parameters** |||\n| `id` | `string` | The ID of a verified site or domain. |\n\n### Authorization\n\nThis request requires authorization with the following scope ([read more about authentication and authorization](/site-verification/v1/getting_started#auth)).\n\n| Scope |\n|----------------------------------------------------|\n| `https://www.googleapis.com/auth/siteverification` |\n\n### Request body\n\nIn the request body, supply a [WebResource resource](/site-verification/v1/webResource#resource).\n\nResponse\n--------\n\n\u003cbr /\u003e\n\nIf successful, this method returns the updated [WebResource resource](/site-verification/v1/webResource#resource) in the response body.\n\n\u003cbr /\u003e\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response.\nAlternatively, try the\n[standalone\nExplorer](https://developers.google.com/apis-explorer/#p/siteVerification/v1/siteVerification.webResource.update)."]]