قبل طلب insert، ضَع الرمز المميّز لإثبات ملكية الحساب الخاص بالمستخدم الذي تمت المصادقة عليه على موقعه الإلكتروني أو نطاقه. عند استدعاء insert، ترسل خدمة "التحقق من الموقع الإلكتروني" من Google طلبًا إلى الموقع الإلكتروني أو النطاق وتبحث عن الرمز المميز.
إذا عثر محرّك بحث Google على الرمز المميّز للمستخدم على الموقع الإلكتروني أو النطاق، سيسجّل الموقع الإلكتروني على أنّه تم إثبات ملكيته.يمكن أيضًا للمستخدم الذي تمت مصادقته تفويض الملكية. يتم أيضًا تسجيل أي عناوين بريد إلكتروني تحدّدها في الحقل owners في نص الطلب كمالكين تم إثبات ملكيتهم للموقع الإلكتروني.
تحدِّد مَعلمة طلب البحث verificationMethod نوع الرمز المميّز لإثبات الملكية الذي يجب أن يتحقّق محرّك بحث Google منه.يجب أن تتطابق قيمة verificationMethod مع القيمة التي تم ضبطها سابقًا إلى getToken.
الطلب
طلب HTTP
POST https://www.googleapis.com/siteVerification/v1/webResource?verificationMethod=method
المعلمات
اسم المعلَمة
القيمة
الوصف
مَعلمات طلب البحث المطلوبة
verificationMethod
string
هي الطريقة المستخدمة لإثبات ملكية موقع إلكتروني أو نطاق.
في حال نجاح هذه الطريقة، سيتم عرض مورد WebResource في نص الاستجابة.
جرّب الآن
يمكنك استخدام "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الردّ.
ويمكنك بدلاً من ذلك تجربة
مستقل
Explorer (المستكشف):
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Site Verification API allows you to programmatically verify ownership of a website or domain using a verification token.\u003c/p\u003e\n"],["\u003cp\u003eBefore verification, you need to place a verification token on your website, obtained via the \u003ccode\u003egetToken\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eThe API confirms ownership by checking for the token and records verified owners, including delegated ones.\u003c/p\u003e\n"],["\u003cp\u003eThis process requires authorization with specific scopes related to site verification.\u003c/p\u003e\n"],["\u003cp\u003eA successful verification returns a WebResource resource, confirming the site or domain ownership.\u003c/p\u003e\n"]]],["To verify website ownership, place the user's verification token, obtained via `getToken`, on the site. Send a POST request to `/site-verification/v1/webResource/insert` with the `verificationMethod` query parameter matching the token type. Google's service checks for the token and records the site as verified if found. You can also specify additional owners in the request body. Ownership is stored and visible to all current and future owners. This request requires authorization with specified scopes.\n"],null,["# WebResource: insert\n\n**Requires [authorization](#auth)**\n\nVerifies ownership of a website or domain.\n[Try it now](#try-it).\n\nBefore calling [insert](/site-verification/v1/webResource/insert), place the authenticated user's [verification token](#method_siteVerification.webResource.getVerificationToken) on their website or domain. When you call [insert](/site-verification/v1/webResource/insert), Google's Site Verification service queries the website or domain and looks for the token.\n| **Note:** Ownership information is stored and visible to other site owners (both current and future).\nIf Google finds the user's token on the website or domain, it records the site as verified. The authenticated user can also delegate ownership; any email addresses you specify in the `owners` field in the request body are also recorded as verified site owners. \n\nThe `verificationMethod` query parameter specifies the verification token type that Google should check for. The value of `verificationMethod` should match the value previously passed to [getToken](/site-verification/v1/webResource/getToken).\n\n\u003cbr /\u003e\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/siteVerification/v1/webResource?verificationMethod=method\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------------|----------|---------------------------------------------------|\n| **Required query parameters** |||\n| `verificationMethod` | `string` | The method to use for verifying a site or domain. |\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes ([read more about authentication and authorization](/site-verification/v1/getting_started#auth)).\n\n| Scope |\n|----------------------------------------------------------------|\n| `https://www.googleapis.com/auth/siteverification` |\n| `https://www.googleapis.com/auth/siteverification.verify_only` |\n\n### Request body\n\nIn the request body, supply a [WebResource resource](/site-verification/v1/webResource#resource).\n\nResponse\n--------\n\nIf successful, this method returns a [WebResource resource](/site-verification/v1/webResource#resource) in the response body.\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.insert)."]]
