- المورد: الحساب
- AccountType
- AccountRole
- VerificationState
- VettedState
- PermissionLevel
- OrganizationInfo
- PostalAddress
- الطُرق
المرجع: الحساب
الحساب هو حاوية لموقعك الجغرافي. إذا كنت المستخدم الوحيد الذي يدير المواقع الجغرافية لنشاطك التجاري، يمكنك استخدام حسابك الشخصي على Google. لمشاركة إدارة مواقع جغرافية مع مستخدمين متعددين، عليك إنشاء حساب نشاط تجاري.
تمثيل JSON |
---|
{ "name": string, "accountName": string, "primaryOwner": string, "type": enum ( |
الحقول | |
---|---|
name |
غير قابل للتغيير. اسم المورد بتنسيق |
accountName |
مطلوب. اسم الحساب بالنسبة إلى الحساب من النوع |
primaryOwner |
مطلوب. الإدخال فقط. اسم المورد للحساب الذي سيكون المالك الأساسي للحساب الذي يتم إنشاؤه. ويجب أن يكون بالصيغة |
type |
مطلوب. يحتوي على نوع الحساب. لا يمكن إنشاء حسابات من النوع PERSONAL و Enterprise باستخدام واجهة برمجة التطبيقات هذه. |
role |
النتائج فقط. تُحدِّد هذا الحقل "دور الحساب" (AccountRole) لهذا الحساب. |
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 (إذا كان معروفًا) وهي غالبًا لغة واجهة المستخدم لنموذج الإدخال أو من المتوقّع أن تتطابق مع إحدى اللغات المستخدمة في العنوان الدولة/المنطقة، أو ما يعادلها صوتيًا. ويمكن أن يؤثر ذلك في التنسيق في بلدان معيّنة، ولكنه ليس ضروريًا لتصحيح البيانات، ولن يؤثر أبدًا في أي عملية تحقّق أو عمليات أخرى غير متعلّقة بالتنسيق. وإذا كانت هذه القيمة غير معروفة، يجب حذفها (بدلاً من تحديد قيمة تلقائية قد تكون غير صحيحة). أمثلة: "zh-Hant" و"ja" و"ja-Latn" و"en". |
postalCode |
اختياريّ. الرمز البريدي للعنوان. لا تستخدِم بعض البلدان الرموز البريدية أو تشترط توفّر هذه الرموز، ولكن عند استخدامها، قد تُجري عمليات تحقُّق إضافية من خلال أجزاء أخرى من العنوان (مثل التحقّق من صحة الولاية أو الرمز البريدي في الولايات المتحدة الأمريكية). |
sortingCode |
اختياريّ. رمز فرز إضافي خاص بالبلد. لا تُستخدم هذه الميزة في معظم المناطق. عند استخدامها، تكون القيمة إما سلسلة مثل "CEDEX"، متبوعة بشكل اختياري برقم (مثل "CEDEX 7")، أو مجرد رقم وحده، يمثّل "رمز القطاع" (جامايكا)، "مؤشر منطقة التسليم" (مالاوي) أو "مؤشر مكتب البريد" (على سبيل المثال: ساحل العاج). |
administrativeArea |
اختياريّ. أعلى تقسيم فرعي إداري يتم استخدامه للعناوين البريدية لبلد أو منطقة. على سبيل المثال، يمكن أن تكون ولاية أو مقاطعة أو مقاطعة أو محافظة. على وجه التحديد، بالنسبة إلى إسبانيا، هذه هي الإقليم وليس المجتمع المستقلّ (على سبيل المثال، "برشلونة" وليس "كاتالونيا"). لا يستخدم العديد من البلدان منطقة إدارية في العناوين البريدية. مثلاً: في سويسرا يجب عدم تعبئة هذا الحقل. |
locality |
اختياريّ. يشير بوجه عام إلى الجزء من المدينة/البلدة من العنوان. أمثلة: مدينة في الولايات المتحدة، بلدية تكنولوجيا المعلومات، بلدة بريد المملكة المتحدة. في مناطق العالم التي لم يتم فيها تحديد المناطق المحلية بشكل جيد أو لا تتناسب مع هذا الهيكل جيدًا، اترك المنطقة المحلية فارغة واستخدم addressLines. |
sublocality |
اختياريّ. المنطقة المحلية الفرعية للعنوان. على سبيل المثال، يمكن أن تكون الأحياء أو المناطق الإدارية أو المناطق. |
addressLines[] |
أسطر عنوان غير منظمة تصف المستويات الأدنى من العنوان. بما أنّ القيم في addressLines لا تحتوي على معلومات النوع وقد تحتوي أحيانًا على قيم متعددة في حقل واحد (على سبيل المثال، "أبو ظبي، تكساس")، من المهم أن يكون ترتيب الأسطر واضحًا. يجب أن يكون ترتيب أسطر العنوان "ترتيب على شكل مغلف". للبلد أو المنطقة التي يقع فيها العنوان. وفي الأماكن التي قد يختلف فيها الاسم (مثل اليابان)، يتم استخدام address_language لجعله صريحًا (على سبيل المثال، "ja" لترتيب الحروف الكبيرة إلى الصغيرة وja-Latn أو "en" للصغير إلى الكبير). وبهذه الطريقة، يمكن تحديد السطر الأكثر تحديدًا للعنوان بناءً على اللغة. إنّ الحد الأدنى المسموح به للتمثيل الهيكلي للعنوان هو رمز المنطقة مع جميع المعلومات المتبقية في سطر العنوان. سيكون من الممكن تنسيق هذا العنوان تقريبًا بدون ترميز جغرافي، ولكن لا يمكن وضع أي تفسير دلالي حول أي من مكونات العنوان حتى يتم حله جزئيًا على الأقل. إنشاء عنوان يحتوي فقط على رمز المنطقة وسطر العنوان، ومن ثمَّ يُعتبر الترميز الجغرافي الطريقة الموصى بها للتعامل مع العناوين غير المنظَّمة تمامًا (بدلاً من تخمين أجزاء العنوان التي يجب أن تكون مناطق محلية أو مناطق إدارية). |
recipients[] |
اختياريّ. المستلِم في العنوان. في حالات معيّنة، قد يحتوي هذا الحقل على معلومات متعددة الأسطر. على سبيل المثال، قد يحتوي على كلمة "رعاية" المعلومات. |
organization |
اختياريّ. تمثّل هذه السمة اسم المؤسسة في العنوان. |
الطُرق |
|
---|---|
|
يتم إنشاء حساب بالاسم والنوع المحدّدَين ضمن العنصر الرئيسي المحدَّد. |
|
الحصول على الحساب المحدّد |
|
يسرد جميع حسابات المستخدم الذي تمت مصادقته. |
|
تعمل هذه السياسة على تعديل حساب النشاط التجاري المحدّد. |