- المورد: الحساب
- AccountType
- AccountRole
- VerificationState
- VettedState
- PermissionLevel
- OrganizationInfo
- PostalAddress
- الطُرق
المرجع: الحساب
الحساب هو حاوية لموقعك الجغرافي. إذا كنت المستخدم الوحيد الذي يدير المواقع الجغرافية لنشاطك التجاري، يمكنك استخدام حسابك الشخصي على Google. لمشاركة إدارة المواقع مع عدة مستخدمين، يمكنك إنشاء حساب نشاط تجاري.
تمثيل JSON |
---|
{ "name": string, "accountName": string, "primaryOwner": string, "type": enum ( |
الحقول | |
---|---|
name |
غير قابل للتغيير. اسم المورد بالتنسيق |
accountName |
مطلوبة. اسم الحساب بالنسبة إلى الحساب من النوع |
primaryOwner |
مطلوبة. الإدخال فقط. اسم مورد الحساب الذي سيكون المالك الأساسي للحساب الذي يتم إنشاؤه يجب أن يكون بالشكل |
type |
مطلوبة. تحتوي على نوع الحساب. لا يمكن إنشاء حسابات من النوع PERSONAL وOrganization باستخدام واجهة برمجة التطبيقات هذه. |
role |
النتائج فقط. تُحدِّد "دور الحساب" لهذا الحساب. |
verificationState |
النتائج فقط. في حال إثبات ملكية المواقع الجغرافية التي سيتم إنشاؤها في المستقبل، يتم ربطها تلقائيًا بـ "خرائط Google"، ويتم إنشاء صفحاتها على Google+ ، بدون الحاجة إلى الإشراف. |
vettedState |
النتائج فقط. يشير إلى ما إذا كانت Google قد تحقّقت من الحساب. يمكن للحساب الذي تم فحصه إثبات ملكية المواقع الجغرافية من خلال طريقة VETTED_PARTNER. |
accountNumber |
النتائج فقط. الرقم المرجعي للحساب إذا تم توفيره. |
permissionLevel |
النتائج فقط. يحدد مستوى الإذن الذي يمتلكه المستخدم لهذا الحساب. |
organizationInfo |
النتائج فقط. يمكنك الاطّلاع على معلومات إضافية لمؤسسة. وتتم تعبئة هذه البيانات لحساب مؤسسة فقط. |
AccountType
يشير إلى نوع الحساب: إما حساب شخصي/حساب مستخدم أو حساب نشاط تجاري.
عمليات التعداد | |
---|---|
ACCOUNT_TYPE_UNSPECIFIED |
غير محدَّد. |
PERSONAL |
حساب مستخدم نهائي. |
LOCATION_GROUP |
مجموعة من المواقع الجغرافية. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة مركز المساعدة. |
USER_GROUP |
مجموعة مستخدمين لفصل موظفي المؤسسة في مجموعات. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة مركز المساعدة. |
ORGANIZATION |
مؤسسة تمثل شركة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة مركز المساعدة. |
AccountRole
تشير هذه السمة إلى مستوى الوصول الذي يملكه المستخدم الذي تمت مصادقته لهذا الحساب. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة مركز المساعدة.
عمليات التعداد | |
---|---|
ACCOUNT_ROLE_UNSPECIFIED |
غير محدَّد. |
PRIMARY_OWNER |
هذا المستخدم هو المالك الأساسي لهذا الحساب. |
OWNER |
مالك الحساب |
MANAGER |
ويمكن للمستخدم إدارة هذا الحساب. |
SITE_MANAGER |
ويمكن للمستخدم إدارة مجموعة محدودة من الميزات للحساب. |
VerificationState
يشير إلى حالة إثبات ملكية الحساب.
عمليات التعداد | |
---|---|
VERIFICATION_STATE_UNSPECIFIED |
غير محدَّد. |
VERIFIED |
تم إثبات ملكية الحساب. |
UNVERIFIED |
لم يتم إثبات ملكية الحساب، ولم يتم طلب إثبات الملكية. |
VERIFICATION_REQUESTED |
لم يتم إثبات ملكية هذا الحساب، ولكن تم طلب إثبات ملكيته. |
VettedState
يشير إلى حالة الحساب التي تم فحصها.
عمليات التعداد | |
---|---|
VETTED_STATE_UNSPECIFIED |
غير محدد |
NOT_VETTED |
لا تتحقّق Google من الحساب. |
VETTED |
تحقّقت Google من الحساب وأنّه بحالة صالحة. يتم فحص الحساب تلقائيًا إذا كان لديه إمكانية الوصول المباشر إلى حساب مجموعة تم فحصه. |
INVALID |
تم التحقّق من الحساب ولكنه في حالته غير صالحة. سيعمل هذا الحساب كحساب لم يتم فحصه. |
PermissionLevel
تشير هذه السمة إلى مستوى الوصول الذي يملكه المستخدم الذي تمت مصادقته لهذا الحساب.
عمليات التعداد | |
---|---|
PERMISSION_LEVEL_UNSPECIFIED |
غير محدَّد. |
OWNER_LEVEL |
لدى المستخدم إذن على مستوى المالك. |
MEMBER_LEVEL |
لدى المستخدم إذن على مستوى العضو. |
OrganizationInfo
المعلومات الإضافية المخزَّنة لمؤسسة.
تمثيل JSON |
---|
{
"registeredDomain": string,
"address": {
object ( |
الحقول | |
---|---|
registeredDomain |
النتائج فقط. النطاق المسجَّل للحساب. |
address |
النتائج فقط. العنوان البريدي للحساب |
phoneNumber |
النتائج فقط. رقم الاتصال بالمؤسسة |
PostalAddress
يمثل عنوانًا بريديًا، على سبيل المثال، لعناوين التسليم البريدي أو الدفع. يمكن لخدمة بريدية تسليم السلع إلى المبنى أو صندوق البريد أو ما شابه ذلك من خلال استخدام عنوان بريدي. ليس الغرض منها تصميم نماذج للمواقع الجغرافية (الطرق والمدن والجبال).
في الاستخدام النموذجي، يتم إنشاء العنوان عن طريق البيانات التي يُدخلها المستخدم أو من استيراد البيانات الحالية، بناءً على نوع العملية.
نصائح حول إدخال أو تعديل العنوان: - استخدِم أداة عنوان جاهزة للاستخدام على نطاق عالمي، مثل https://github.com/google/libaddressinput) - يجب ألا تظهر للمستخدمين عناصر واجهة المستخدم لإدخال الحقول أو تعديلها خارج البلدان حيث يتم استخدام ذلك الحقل.
لمزيد من الإرشادات حول كيفية استخدام هذا المخطط، يُرجى الاطّلاع على: https://support.google.com/business/answer/6397478
تمثيل JSON |
---|
{ "revision": integer, "regionCode": string, "languageCode": string, "postalCode": string, "sortingCode": string, "administrativeArea": string, "locality": string, "sublocality": string, "addressLines": [ string ], "recipients": [ string ], "organization": string } |
الحقول | |
---|---|
revision |
النسخة السابقة من المخطط من يجب أن تكون جميع النُسخ الجديدة متوافقة مع الإصدارات القديمة. |
regionCode |
مطلوبة. رمز CLDR للمنطقة للدولة/المنطقة حيث يقع العنوان لا يتم استنتاج هذه المعلومات على الإطلاق، وعلى المستخدم التأكّد من صحة القيمة. للاطّلاع على التفاصيل، يمكنك الانتقال إلى https://cldr.unicode.org/ وhttps://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. على سبيل المثال: "CH" لسويسرا. |
languageCode |
اختياريّ. رمز اللغة BCP-47 لمحتوى هذا العنوان (إذا كان معروفًا). وغالبًا ما تكون هذه اللغة هي لغة واجهة المستخدم في نموذج الإدخال، أو يُتوقّع أن تتطابق مع إحدى اللغات المستخدَمة في بلد أو منطقة العنوان أو ما يكافئها صوتيًا. يمكن أن يؤثر هذا على التنسيق في بلدان معينة، لكنه ليس بالغ الأهمية لصحة البيانات ولن يؤثر أبدًا على أي عمليات تحقق أو عمليات أخرى غير متعلقة بالتنسيق. إذا كانت هذه القيمة غير معروفة، يجب حذفها (بدلاً من تحديد قيمة تلقائية قد تكون غير صحيحة). أمثلة: "sa-Hant" و"ja" و"ja-Latn" و"en". |
postalCode |
اختياريّ. الرمز البريدي للعنوان لا تستخدم جميع البلدان الرموز البريدية أو تشترطها، ولكن في أماكن استخدامها، قد تبدأ عملية تحقّق إضافية من خلال استخدام أجزاء أخرى من العنوان (مثل إثبات صحة البيانات حسب الولاية أو الرمز البريدي في الولايات المتحدة الأمريكية). |
sortingCode |
اختياريّ. رمز ترتيب إضافي خاص بالبلد ولا يتم استخدام هذه الطريقة في معظم المناطق. وعند استخدامها، تكون القيمة إما سلسلة مثل "CEDEX"، متبوعة برقم اختياري (مثل "CEDEX 7")، أو رقم فقط يمثّل "رمز القطاع" (Jamaica) أو "مؤشر منطقة التسليم" (مالاوي) أو "مؤشر مكتب البريد" (مثل ساحل العاج). |
administrativeArea |
اختياريّ. أعلى تقسيم فرعي إداري يُستخدم للعناوين البريدية لبلد أو منطقة. على سبيل المثال، يمكن أن تكون ولاية أو مقاطعة أو مقاطعة أو محافظة. وعلى وجه التحديد، بالنسبة إلى إسبانيا، تكون هذه المقاطعة وليست المجتمع المستقل (مثل "برشلونة" وليس "كاتالونيا"). لا يستخدم العديد من البلدان منطقة إدارية في العناوين البريدية. في سويسرا مثلاً، يجب ترك هذا الحقل فارغًا. |
locality |
اختياريّ. يشير بوجه عام إلى جزء المدينة/البلدة من العنوان. أمثلة: مدينة في الولايات المتحدة، بلدية تكنولوجيا المعلومات، مدينة البريد في المملكة المتحدة. في مناطق العالم حيث لم يتم تعريف المناطق المحلية بشكل جيد أو لا تتناسب مع هذا الهيكل بشكل جيد، اترك المنطقة المحلية فارغة واستخدم addressLines. |
sublocality |
اختياريّ. المنطقة المحلية الفرعية للعنوان. على سبيل المثال، يمكن أن يشمل ذلك الأحياء والأحياء والأحياء. |
addressLines[] |
أسطر عناوين غير مهيكلة تصف المستويات الأدنى من العنوان. نظرًا لأن القيم في addressLines لا تحتوي على معلومات النوع وقد تحتوي أحيانًا على قيم متعددة في حقل واحد (على سبيل المثال، "Austin, TX")، من المهم أن يكون ترتيب الأسطر واضحًا. يجب أن يكون ترتيب سطور العنوان هو "ترتيب المغلف" للبلد/منطقة العنوان. وفي الأماكن التي يمكن أن يختلف فيها ذلك (مثل اليابان)، يتم استخدام address_language لجعله واضحًا (مثل "ja" للطلبات الكبيرة إلى الصغيرة و "ja-Latn" أو "en" للأحجام الصغيرة إلى الكبيرة). وبهذه الطريقة، يمكن تحديد السطر الأكثر تحديدًا في العنوان استنادًا إلى اللغة. يتألف الحد الأدنى المسموح به من التمثيل الهيكلي للعنوان من رمز المنطقة مع وضع جميع المعلومات المتبقية في سطور العنوان. وكان من الممكن تنسيق مثل هذا العنوان بشكل تقريبي بدون ترميز جغرافي، ولكن لا يمكن الاستدلال على أي من مكونات العنوان حتى يتم حله جزئيًا على الأقل. إنشاء عنوان يحتوي فقط على رمز المنطقة وaddressLines، ومن ثم الترميز الجغرافي هو الطريقة الموصى بها للتعامل مع العناوين غير المنظَّمة تمامًا (بدلاً من تخمين أجزاء العنوان التي يجب أن تكون مناطق محلية أو مناطق إدارية). |
recipients[] |
اختياريّ. المستلم في العنوان. قد يحتوي هذا الحقل، في ظروف معيّنة، على معلومات متعددة الأسطر. على سبيل المثال، قد تحتوي على معلومات حول "الاهتمام". |
organization |
اختياريّ. اسم المؤسسة في العنوان. |
الطُرق |
|
---|---|
|
ينشئ حسابًا بالاسم والنوع المحدّدين ضمن العنصر الرئيسي المحدّد. |
|
الحصول على الحساب المحدد |
|
يسرد جميع حسابات المستخدم الذي تمت مصادقته. |
|
تعديل حساب النشاط التجاري المحدّد |