REST Resource: accounts

المرجع: الحساب

الحساب هو حاوية لموقعك الجغرافي. إذا كنت المستخدم الوحيد الذي يدير المواقع الجغرافية لنشاطك التجاري، يمكنك استخدام حسابك الشخصي على Google. لمشاركة إدارة مواقع جغرافية مع مستخدمين متعددين، عليك إنشاء حساب نشاط تجاري.

تمثيل JSON
{
  "name": string,
  "accountName": string,
  "primaryOwner": string,
  "type": enum (AccountType),
  "role": enum (AccountRole),
  "verificationState": enum (VerificationState),
  "vettedState": enum (VettedState),
  "accountNumber": string,
  "permissionLevel": enum (PermissionLevel),
  "organizationInfo": {
    object (OrganizationInfo)
  }
}
الحقول
name

string

غير قابل للتغيير. اسم المورد بتنسيق accounts/{account_id}.

accountName

string

مطلوب. اسم الحساب بالنسبة إلى الحساب من النوع PERSONAL، يكون هذا هو الاسم الأول والأخير لحساب المستخدم.

primaryOwner

string

مطلوب. الإدخال فقط. اسم المورد للحساب الذي سيكون المالك الأساسي للحساب الذي يتم إنشاؤه. ويجب أن يكون بالصيغة accounts/{account_id}.

type

enum (AccountType)

مطلوب. يحتوي على نوع الحساب. لا يمكن إنشاء حسابات من النوع PERSONAL و Enterprise باستخدام واجهة برمجة التطبيقات هذه.

role

enum (AccountRole)

النتائج فقط. تُحدِّد هذا الحقل "دور الحساب" (AccountRole) لهذا الحساب.

verificationState

enum (VerificationState)

النتائج فقط. في حالة إثبات الملكية، فإن المواقع المستقبلية التي يتم إنشاؤها سيتم ربطها تلقائيًا بخرائط Google، ويتم إنشاء صفحات Google+ دون الحاجة إلى الإشراف.

vettedState

enum (VettedState)

النتائج فقط. تشير هذه القيمة إلى ما إذا تم التحقّق من الحساب من قِبل Google أم لا. يمكن للحساب الذي تم التحقق منه إثبات ملكية المواقع عبر طريقة VETTED_PARTNER.

accountNumber

string

النتائج فقط. الرقم المرجعي للحساب في حال توفّره.

permissionLevel

enum (PermissionLevel)

النتائج فقط. تُحدِّد مستوى الإذن الذي يمتلكه المستخدم لهذا الحساب.

organizationInfo

object (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 (PostalAddress)
  },
  "phoneNumber": string
}
الحقول
registeredDomain

string

النتائج فقط. النطاق المسجَّل للحساب.

address

object (PostalAddress)

النتائج فقط. العنوان البريدي للحساب

phoneNumber

string

النتائج فقط. تمثّل هذه السمة رقم جهة الاتّصال للمؤسسة.

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

integer

تمثّل هذه السمة مراجعة المخطط لـ PostalAddress. يجب تعيين هذا على 0، وهي أحدث مراجعة.

يجب أن تكون جميع النُسخ السابقة متوافقة مع الإصدارات القديمة.

regionCode

string

مطلوب. رمز CLDR للبلد أو المنطقة التي يقع فيها العنوان. لا يتم استنتاج ذلك أبدًا، وتقع على عاتق المستخدم مسؤولية التأكّد من صحة القيمة. يمكنك الانتقال إلى https://cldr.unicode.org/ وhttps://www.unicode.org/cldr/charts/30/supplemental/territory_information.html لمعرفة التفاصيل. مثال: "CH" لسويسرا.

languageCode

string

اختياريّ. رمز لغة محتوى هذا العنوان BCP-47 (إذا كان معروفًا) وهي غالبًا لغة واجهة المستخدم لنموذج الإدخال أو من المتوقّع أن تتطابق مع إحدى اللغات المستخدمة في العنوان الدولة/المنطقة، أو ما يعادلها صوتيًا. ويمكن أن يؤثر ذلك في التنسيق في بلدان معيّنة، ولكنه ليس ضروريًا لتصحيح البيانات، ولن يؤثر أبدًا في أي عملية تحقّق أو عمليات أخرى غير متعلّقة بالتنسيق.

وإذا كانت هذه القيمة غير معروفة، يجب حذفها (بدلاً من تحديد قيمة تلقائية قد تكون غير صحيحة).

أمثلة: "zh-Hant" و"ja" و"ja-Latn" و"en".

postalCode

string

اختياريّ. الرمز البريدي للعنوان. لا تستخدِم بعض البلدان الرموز البريدية أو تشترط توفّر هذه الرموز، ولكن عند استخدامها، قد تُجري عمليات تحقُّق إضافية من خلال أجزاء أخرى من العنوان (مثل التحقّق من صحة الولاية أو الرمز البريدي في الولايات المتحدة الأمريكية).

sortingCode

string

اختياريّ. رمز فرز إضافي خاص بالبلد. لا تُستخدم هذه الميزة في معظم المناطق. عند استخدامها، تكون القيمة إما سلسلة مثل "CEDEX"، متبوعة بشكل اختياري برقم (مثل "CEDEX 7")، أو مجرد رقم وحده، يمثّل "رمز القطاع" (جامايكا)، "مؤشر منطقة التسليم" (مالاوي) أو "مؤشر مكتب البريد" (على سبيل المثال: ساحل العاج).

administrativeArea

string

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

locality

string

اختياريّ. يشير بوجه عام إلى الجزء من المدينة/البلدة من العنوان. أمثلة: مدينة في الولايات المتحدة، بلدية تكنولوجيا المعلومات، بلدة بريد المملكة المتحدة. في مناطق العالم التي لم يتم فيها تحديد المناطق المحلية بشكل جيد أو لا تتناسب مع هذا الهيكل جيدًا، اترك المنطقة المحلية فارغة واستخدم addressLines.

sublocality

string

اختياريّ. المنطقة المحلية الفرعية للعنوان. على سبيل المثال، يمكن أن تكون الأحياء أو المناطق الإدارية أو المناطق.

addressLines[]

string

أسطر عنوان غير منظمة تصف المستويات الأدنى من العنوان.

بما أنّ القيم في addressLines لا تحتوي على معلومات النوع وقد تحتوي أحيانًا على قيم متعددة في حقل واحد (على سبيل المثال، "أبو ظبي، تكساس")، من المهم أن يكون ترتيب الأسطر واضحًا. يجب أن يكون ترتيب أسطر العنوان "ترتيب على شكل مغلف". للبلد أو المنطقة التي يقع فيها العنوان. وفي الأماكن التي قد يختلف فيها الاسم (مثل اليابان)، يتم استخدام address_language لجعله صريحًا (على سبيل المثال، "ja" لترتيب الحروف الكبيرة إلى الصغيرة وja-Latn أو "en" للصغير إلى الكبير). وبهذه الطريقة، يمكن تحديد السطر الأكثر تحديدًا للعنوان بناءً على اللغة.

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

إنشاء عنوان يحتوي فقط على رمز المنطقة وسطر العنوان، ومن ثمَّ يُعتبر الترميز الجغرافي الطريقة الموصى بها للتعامل مع العناوين غير المنظَّمة تمامًا (بدلاً من تخمين أجزاء العنوان التي يجب أن تكون مناطق محلية أو مناطق إدارية).

recipients[]

string

اختياريّ. المستلِم في العنوان. في حالات معيّنة، قد يحتوي هذا الحقل على معلومات متعددة الأسطر. على سبيل المثال، قد يحتوي على كلمة "رعاية" المعلومات.

organization

string

اختياريّ. تمثّل هذه السمة اسم المؤسسة في العنوان.

الطُرق

create

يتم إنشاء حساب بالاسم والنوع المحدّدَين ضمن العنصر الرئيسي المحدَّد.

get

الحصول على الحساب المحدّد

list

يسرد جميع حسابات المستخدم الذي تمت مصادقته.

patch

تعمل هذه السياسة على تعديل حساب النشاط التجاري المحدّد.