Package google.mybusiness.verifications.v1

الفهرس

التأكد من صحة التراخيص

تتيح واجهة برمجة التطبيقات هذه إدارة عمليات إثبات ملكية المواقع الجغرافية على Google. ويتيح لك ذلك إدارة موارد [إثبات الملكية] [google.mybusiness.v1.verification].

يتضمّن كل موقع في [google.mybusiness.businessinformation.locations.v1.Location] مجموعة من موارد [إثبات الهوية] [google.mybusiness.verifications]، باسم locations/*/verifications/*.

CompleteVerification

rpc CompleteVerification(CompleteVerificationRequest) returns (CompleteVerificationResponse)

إكمال عملية إثبات الهوية من خلال "PENDING"

هذا الإجراء ضروري فقط لطرق إثبات الملكية التي لا تتوافق مع AUTO. طلب إثبات ملكية AUTO يتم تطبيقه بشكل فوري على VERIFIED عند الإنشاء.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/business.manage

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
FetchVerificationOptions

rpc FetchVerificationOptions(FetchVerificationOptionsRequest) returns (FetchVerificationOptionsResponse)

تعمل هذه السياسة على الإبلاغ عن جميع خيارات إثبات الملكية المؤهّلة لموقع جغرافي معيّن بلغة معيّنة.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/business.manage

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
ListVerifications

rpc ListVerifications(ListVerificationsRequest) returns (ListVerificationsResponse)

سرد عمليات إثبات ملكية الموقع الجغرافي، مرتبة حسب وقت الإنشاء.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/business.manage

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
VerifyLocation

rpc VerifyLocation(VerifyLocationRequest) returns (VerifyLocationResponse)

بدء عملية إثبات ملكية موقع جغرافي

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/business.manage

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.

VoiceOfMerchant

تسمح هذه الخدمة للمستخدمين التابعين لجهات خارجية بطلب تفاصيل عن خدمة Voice of Merchant Center.

GetVoiceOfMerchantState

rpc GetVoiceOfMerchantState(GetVoiceOfMerchantStateRequest) returns (VoiceOfMerchantState)

الحصول على حالة VoiceOfMerchant

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/business.manage

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.

CompleteVerificationRequest

طلب رسالة لإجراء عمليات التحقّق.CompleteCheckAction.

الحقول
name

string

مطلوبة. اسم مورد إثبات الملكية المطلوب إكماله.
pin

string

مطلوبة. رمز رقم التعريف الشخصي الذي استلمه التاجر لإكمال عملية إثبات الملكية

CompleteVerificationResponse

رسالة الردّ على Checks.CompleteverificationAction.

الحقول
verification

Verification

اكتملت عملية إثبات الهوية.

ComplyWithGuidelines

يشير إلى عدم التزام الموقع بما ورد في إرشاداتنا.

الحقول
recommendation_reason

RecommendationReason

سبب اقتراح الموقع الجغرافي للالتزام بالإرشادات.

RecommendationReason

يشير إلى سبب اقتراح الموقع الجغرافي من أجل الالتزام بالإرشادات.

عمليات التعداد
RECOMMENDATION_REASON_UNSPECIFIED غير محدَّد.
BUSINESS_LOCATION_SUSPENDED تم تعليق الموقع الجغرافي للنشاط التجاري. لحلّ هذه المشكلة، يمكنك الاطّلاع على مقالة مركز المساعدة.
BUSINESS_LOCATION_DISABLED الموقع الجغرافي للنشاط التجاري غير مفعّل. لحلّ هذه المشكلة، يمكنك الاطّلاع على مقالة مركز المساعدة.

FetchVerificationOptionsRequest

طلب رسالة للتحقّق من خيار التحقّق من عمليات التحقّق.

الحقول
location

string

مطلوبة. الموقع الجغرافي المطلوب إثبات ملكيته.
language_code

string

مطلوبة. رمز اللغة BCP 47 الذي يمثّل اللغة التي سيتم استخدامها في عملية التحقّق من المعلِن. تختلف الخيارات المتاحة حسب اللغة.
context

ServiceBusinessContext

اختياريّ. معلومات سياق إضافية لإثبات ملكية الأنشطة التجارية الخدمية لا يمكن تطبيق هذا الخيار إلا على المواقع الجغرافية التي يكون نوع نشاطها التجاري CUSTOMER_LOCATION_ONLY. يؤدي تحديد عنوان دقيق إلى تمكين المزيد من الخيارات. سيتم إلغاء INVALID_{9} إذا تم تعيينه لأنواع أنشطة تجارية أخرى من المواقع.

FetchVerificationOptionsResponse

رسالة الرد لـverifications.FetchPendingOptions.

الحقول
options[]

VerificationOption

خيارات إثبات الملكية المتاحة.

GetVoiceOfMerchantStateRequest

طلب رسالة إلى VoiceOfMerchant.GetVoiceOfMerchantState

الحقول
name

string

مطلوبة. اسم المورد للموقع الجغرافي

ListVerificationsRequest

طلب رسالة للتحقّق من المعلِنين.

الحقول
parent

string

مطلوبة. اسم المورد للموقع الجغرافي الذي تنتمي إليه طلبات إثبات الملكية.
page_size

int32

عدد عمليات إثبات الملكية المطلوب تضمينها في كل صفحة. الحد الأدنى هو 1، والأقصى التلقائي والأقصى لحجم الصفحة هو 100.
page_token

string

في حال تحديد ذلك، يتم عرض الصفحة التالية من عمليات إثبات الملكية.

ListVerificationsResponse

رسالة الردّ على Checks.ListChecks

الحقول
verifications[]

Verification

قائمة بعمليات إثبات الملكية
next_page_token

string

إذا تجاوز عدد عمليات إثبات الملكية حجم الصفحة المطلوب، ستتم تعبئة هذا الحقل برمز مميّز لجلب الصفحة التالية من عملية إثبات الملكية عند إجراء مكالمة لاحقة. إذا لم يكن هناك المزيد من السمات، لن يكون هذا الحقل متوفّرًا في الرد.

ResolveOwnershipConflict

لا يحتوي هذا النوع على أي حقول.

يشير إلى أن الموقع يكرر موقعًا آخر في وضع جيد.

ServiceBusinessContext

بيانات إضافية لإثبات ملكية النشاط التجاري الخدمي

الحقول
address

PostalAddress

عنوان إثبات ملكية الموقع الجغرافي. ويتم استخدامه لتفعيل المزيد من خيارات إثبات الملكية أو إرسال بطاقة بريدية.

إثبات الملكية

يشير إثبات الملكية إلى محاولة إثبات ملكية موقع جغرافي.

الحقول
name

string

اسم مورد إثبات الملكية.
method

VerificationMethod

طريقة إثبات الملكية.
state

State

تمثّل هذه السمة حالة إثبات الملكية.
create_time

Timestamp

الطابع الزمني الذي يتم عنده طلب إثبات الملكية.
announcement

string

اختياريّ. لا يتم تعيين إشعار الرد إلا إذا كانت الطريقة هي VETTED_PARTNER.

الحالة

جميع حالات إثبات الهوية الممكنة.

عمليات التعداد
STATE_UNSPECIFIED وسيؤدي استخدام القيمة التلقائية إلى حدوث أخطاء.
PENDING عملية إثبات الهوية في انتظار المراجعة.
COMPLETED اكتملت عملية إثبات الهوية.
FAILED تعذّر إثبات الملكية.

VerificationMethod

تحدّد العمليات التي تستخدمها Google لإثبات ملكية الموقع الجغرافي.

عمليات التعداد
VERIFICATION_METHOD_UNSPECIFIED وسيؤدي استخدام القيمة التلقائية إلى حدوث أخطاء.
ADDRESS أرسِل بطاقة بريدية تحتوي على رقم التعريف الشخصي لإثبات الملكية إلى عنوان بريدي محدد. يُستخدم رقم التعريف الشخصي لإكمال عملية التحقّق من خلال Google.
EMAIL إرسال رسالة إلكترونية تتضمّن رقم التعريف الشخصي لإثبات الملكية إلى عنوان بريد إلكتروني محدّد يُستخدم رقم التعريف الشخصي لإكمال عملية التحقّق من خلال Google.
PHONE_CALL يمكنك إجراء مكالمة هاتفية باستخدام رقم تعريف شخصي لإثبات الملكية إلى رقم هاتف محدّد. يُستخدم رقم التعريف الشخصي لإكمال عملية التحقّق من خلال Google.
SMS يمكنك إرسال رسالة قصيرة تحتوي على رقم التعريف الشخصي لإثبات الملكية إلى رقم هاتف محدّد. يُستخدم رقم التعريف الشخصي لإكمال عملية التحقّق من خلال Google.
AUTO أثبِت ملكية الموقع الجغرافي بدون اتّخاذ أي إجراء إضافي من المستخدم. قد لا يكون هذا الخيار متاحًا لجميع المواقع الجغرافية.
VETTED_PARTNER قد لا يكون هذا الخيار متاحًا لجميع المواقع الجغرافية.

VerificationOption

يمثّل خيار إثبات الملكية طريقة إثبات ملكية الموقع الجغرافي (الموضّحة من خلال طريقة إثبات الملكية) والمكان الذي سيتم إرسال إثبات الملكية إليه (المحدَّد من خلال بيانات العرض).

الحقول
verification_method

VerificationMethod

طريقة للتحقق من الموقع.
حقل الاتحاد DisplayData إحدى بيانات العرض يجب أن تتطابق البيانات مع الطريقة. يكون هذا الحقل فارغًا إذا لم تتضمّن الطريقة المقابلة أي بيانات عرض. يمكن أن تكون السمة "DisplayData" واحدة فقط مما يلي:
phone_number

string

لا يتم تعيينها إلا إذا كانت الطريقة هي PHONE_CALL أو رسالة SMS. رقم الهاتف الذي سيتم إرسال رقم التعريف الشخصي إليه
address_data

AddressVerificationData

لا يتم التعيين إلا إذا كانت الطريقة هي يسر.
email_data

EmailVerificationData

لا يتم التعيين إلا إذا كانت الطريقة هي EMAIL.
announcement

string

لا يتم التعيين إلا إذا كانت الطريقة هي VETTED_PARTNER.

AddressVerificationData

عرض بيانات عمليات إثبات الملكية من خلال البطاقة البريدية.

الحقول
business

string

اسم النشاط التجاري للتاجر.
address

PostalAddress

العنوان الذي يمكن إرسال بطاقة بريدية إليه.
expected_delivery_days_region

int32

العدد المتوقَّع للأيام التي يستغرقها تسليم بطاقة بريدية إلى منطقة العنوان.

EmailVerificationData

يمكنك عرض بيانات عمليات إثبات الهوية عبر البريد الإلكتروني.

الحقول
domain

string

اسم النطاق في عنوان البريد الإلكتروني. على سبيل المثال، "gmail.com" في foo@gmail.com
user

string

اسم المستخدم في عنوان البريد الإلكتروني، مثل "foo" في foo@gmail.com
is_user_name_editable

bool

ما إذا كان يُسمَح للعميل بتقديم اسم مستخدم مختلف.

VerificationToken

الرمز المميّز الذي ينشئه شريك تم فحصه

الحقول
token_string

string

سلسلة الرمز المميّز

إثبات الهوية

يشير إلى أن الموقع يتطلب إثبات الملكية. يحتوي على معلومات عن إجراءات إثبات الملكية الحالية التي يتم تنفيذها في الموقع الجغرافي.

الحقول
has_pending_verification

bool

تشير هذه السمة إلى ما إذا كانت عملية إثبات الهوية قد بدأت، ويمكن إكمالها حسب الموقع الجغرافي.

VerifyLocationRequest

طلب رسالة لإجراء عمليات التحقّق من الموقع الجغرافي

الحقول
name

string

مطلوبة. اسم المورد للموقع الجغرافي المطلوب إثبات ملكيته
method

VerificationMethod

مطلوبة. طريقة إثبات الملكية.
language_code

string

اختياريّ. رمز اللغة BCP 47 الذي يمثّل اللغة التي سيتم استخدامها في عملية التحقّق من المعلِن.
context

ServiceBusinessContext

اختياريّ. معلومات سياق إضافية لإثبات ملكية الأنشطة التجارية الخدمية وهو مطلوب فقط للمواقع الجغرافية التي يكون نوع نشاطها التجاري CUSTOMER_LOCATION_ONLY. للتحقق من العنوان ADDRESS، سيتم استخدام العنوان لإرسال بطاقة بريدية. بالنسبة إلى الطرق الأخرى، يجب أن تكون هي الطريقة التي تم تمريرها إلى GetCheckOptions. سيتم إلغاء INVALID_{9} إذا تم تعيينه لأنواع أخرى من المواقع الجغرافية للنشاط التجاري.
حقل الاتحاد RequestData بيانات يدخلها المستخدم لطريقة معيّنة بالإضافة إلى بيانات العرض يجب أن تتطابق البيانات مع الطريقة المطلوبة. ويمكنك تركه فارغًا إذا لم تكن هناك حاجة إلى البيانات. يمكن أن تكون السمة "RequestData" واحدة فقط مما يلي:
email_address

string

اختياريّ. إدخال طريقة EMAIL. عنوان البريد الإلكتروني الذي يجب إرسال رقم التعريف الشخصي إليه.

لا يتم قبول عنوان بريد إلكتروني إلا إذا كان أحد العناوين التي توفِّرها ميزة FetchCheckOptions. في حال ضبط [EmailverificationData] [google.mybusiness-verifications.v1.verificationOption.EmailCheckData] ضبط الإعداد is_user_name_able على "صحيح"، يمكن للعميل تحديد اسم مستخدم مختلف (جزء محلي) ولكن يجب أن يتطابق مع اسم النطاق.
mailer_contact

string

اختياريّ. إدخال طريقة ADDRESS. اسم جهة الاتصال الذي يجب إرسال البريد إليه.
phone_number

string

اختياريّ. إدخال طريقة PHONE_CALL/SMS رقم الهاتف الذي ينبغي الاتصال به أو إرسال رسالة قصيرة SMS إليه. يجب أن يكون أحد أرقام الهواتف في الخيارات المؤهَّلة.
token

VerificationToken

اختياريّ. يتوفّر إدخال طريقة VETTED_PARTNER لمجموعة محدَّدة من partners. لا يلزم إدخال بيانات لحساب تم التحقق منه. الرمز المميّز المرتبط بالموقع الجغرافي الرمز المميّز المرتبط بالموقع الجغرافي

VerifyLocationResponse

رسالة رد لإثبات ملكية الموقع الإلكتروني التحقّق من الموقع الجغرافي

الحقول
verification

Verification

طلب إثبات الملكية الذي تم إنشاؤه.

VoiceOfMerchantState

رسالة ردّ لـ VoiceOfMerchant.GetVoiceOfMerchantState

الحقول
has_voice_of_merchant

bool

يشير إلى ما إذا كان الموقع الجغرافي في وضع جيد ويتحكّم في النشاط التجاري على Google. سيتم نشر أي تعديلات يتم إجراؤها على الموقع الجغرافي على "خرائط Google" بعد اجتياز مرحلة المراجعة.
has_business_authority

bool

يشير إلى ما إذا كان الموقع الجغرافي يمتلك السلطة (الملكية) على النشاط التجاري على Google. في حال صحة ذلك، لا يمكن أن يحتل موقع جغرافي آخر مكانة بارزة في "خرائط Google". ومع ذلك، لن يتم نشر التعديلات ما لم يتم اكتساب Voice of Merchant Center (على سبيل المثال، has_voice_of_merchant صحيح).
حقل الاتحاد gain_voice_of_merchant_action الإجراء الموصى به للموقع الجغرافي للتحكّم في النشاط التجاري على Google. يمكن أن تكون السمة "gain_voice_of_merchant_action" واحدة فقط مما يلي:
wait_for_voice_of_merchant

WaitForVoiceOfMerchant

انتظِر للاطّلاع على خدمة Voice of Merchant. الموقع الجغرافي قيد المراجعة لأغراض الجودة.
verify

Verify

ابدأ عملية إثبات الملكية أو تابعها.
resolve_ownership_conflict

ResolveOwnershipConflict

هذا الموقع يكرر موقعًا آخر في وضع جيد. إذا كان بإمكانك الوصول إلى الموقع الجغرافي في وضع جيد، استخدِم معرّف هذا الموقع الجغرافي لتنفيذ عمليات معيّنة. بخلاف ذلك، يمكنك طلب الوصول من المالك الحالي.
comply_with_guidelines

ComplyWithGuidelines

لا يلتزم الموقع الجغرافي بما ورد في إرشاداتنا ويتطلب خطوات إضافية لاستعادته. لحلّ هذه المشكلة، يُرجى الاطّلاع على مقالة "مركز المساعدة".

WaitForVoiceOfMerchant

لا يحتوي هذا النوع على أي حقول.

تشير هذه السمة إلى أنّ الموقع الجغرافي سيحصل على صوت التاجر بعد اجتياز المراجعة.