WebResource: getToken

يتطلّب تفويضًا

الحصول على رمز مميز لإثبات الملكية للمستخدم الذي تمت المصادقة عليه لوضعه على موقع إلكتروني أو نطاق تجربة ذلك الآن

الطلب

طلب HTTP

POST https://www.googleapis.com/siteVerification/v1/token

التفويض

يتطلب هذا الطلب تفويضًا باستخدام نطاق واحد على الأقل من النطاقات التالية (مزيد من المعلومات عن المصادقة والتفويض).

النطاق
https://www.googleapis.com/auth/siteverification
https://www.googleapis.com/auth/siteverification.verify_only

نص الطلب

في نص الطلب، وفِّر البيانات بالبنية التالية:

{
  "site": {
    "type": string,
    "identifier": string
  },
  "verificationMethod": string
}
اسم الموقع القيمة الوصف ملاحظات
site object حاوية لعنوان الموقع الإلكتروني ونوعه التي سيتم إنشاء رمز مميز للتحقُّق لها.
site.type string نوع المورد المطلوب إثبات ملكيته.

في ما يلي القيم المقبولة:
  • "ANDROID_APP"
  • "INET_DOMAIN"
  • "SITE"
site.identifier string معرِّف الموقع الإلكتروني. وإذا تم ضبط النوع على SITE، يكون المعرّف هو عنوان URL. وإذا تم ضبط النوع على INET_DOMAIN، يكون المعرّف عبارة عن اسم نطاق.
verificationMethod string طريقة إثبات الملكية التي يستخدمها نظام "إثبات ملكية الموقع الإلكتروني" لإثبات ملكية هذا الموقع الإلكتروني أو النطاق.

في ما يلي القيم المقبولة:
  • "ANALYTICS": المواقع الإلكترونية فقط
  • "DNS": استخدام DNS_TXT بدلاً من ذلك
  • "DNS_CNAME": النطاقات فقط
  • "DNS_TXT": النطاقات فقط
  • "FILE": المواقع الإلكترونية فقط
  • "META": المواقع الإلكترونية فقط
  • "TAG_MANAGER": المواقع الإلكترونية فقط

الرد

في حال نجاح هذه الطريقة، سيتم عرض نص استجابة بالبنية التالية:

{
  "method": string,
  "token": string
}
اسم الموقع القيمة الوصف ملاحظات
method string طريقة إثبات الملكية التي اخترتها في الطلب

في ما يلي القيم المقبولة:
  • "ANALYTICS"
  • "DNS"
  • "DNS_CNAME"
  • "DNS_TXT"
  • "FILE"
  • "META"
  • "TAG_MANAGER"
token string السلسلة المطلوب وضعها على الموقع الإلكتروني للمستخدم الذي تمت مصادقته، باستخدام طريقة إثبات الملكية المحدَّدة. لمزيد من المعلومات، راجِع طرق إثبات الملكية والرموز المميّزة في مستند "البدء".

جرّب الآن

يمكنك استخدام "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الردّ. ويمكنك بدلاً من ذلك تجربة مستقل Explorer (المستكشف):