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 وOrganization باستخدام واجهة برمجة التطبيقات هذه.
role

enum (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 لمحتوى هذا العنوان (إذا كان معروفًا). وغالبًا ما تكون هذه اللغة هي لغة واجهة المستخدم في نموذج الإدخال، أو يُتوقّع أن تتطابق مع إحدى اللغات المستخدَمة في بلد أو منطقة العنوان أو ما يكافئها صوتيًا. يمكن أن يؤثر هذا على التنسيق في بلدان معينة، لكنه ليس بالغ الأهمية لصحة البيانات ولن يؤثر أبدًا على أي عمليات تحقق أو عمليات أخرى غير متعلقة بالتنسيق.

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

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

string

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

string

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

string

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

string

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

string

اختياريّ. المنطقة المحلية الفرعية للعنوان. على سبيل المثال، يمكن أن يشمل ذلك الأحياء والأحياء والأحياء.
addressLines[]

string

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

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

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

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

string

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

string

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

الطُرق

create

 ينشئ حسابًا بالاسم والنوع المحدّدين ضمن العنصر الرئيسي المحدّد.

get

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

list

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

patch

 تعديل حساب النشاط التجاري المحدّد