REST Resource: accounts

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

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

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

يتضمن إنشاء حساب ضبط سمات مثل اسم الحساب والمنطقة الزمنية والإعدادات المفضّلة للغة.

رسالة Account هي العنصر الرئيسي للعديد من الموارد الأخرى، مثل AccountRelationship وHomepage وBusinessInfo وما إلى ذلك.

تمثيل JSON
{
  "name": string,
  "accountId": string,
  "accountName": string,
  "adultContent": boolean,
  "testAccount": boolean,
  "timeZone": {
    object (TimeZone)
  },
  "languageCode": string
}
الحقول
name

string

المعرّف اسم المورد للحساب التنسيق: accounts/{account}

accountId

string (int64 format)

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

accountName

string

مطلوب. اسم الحساب السهل القراءة اطّلِع على اسم المتجر واسم النشاط التجاري للحصول على مزيد من المعلومات.

adultContent

boolean

ما إذا كان هذا الحساب يتضمّن محتوى للبالغين

testAccount

boolean

النتائج فقط. ما إذا كان هذا حسابًا اختباريًا

timeZone

object (TimeZone)

مطلوب. المنطقة الزمنية للحساب.

عند الكتابة، يضبط timeZone كلّ من reporting_time_zone وdisplay_time_zone.

بالنسبة إلى عمليات القراءة، يعرض timeZone دائمًا display_time_zone. إذا لم يكن display_time_zone متوفّرًا لحسابك، تكون قيمة timeZone فارغة.

languageCode

string

مطلوب. رمز اللغة وفق معيار BCP-47 للحساب، مثل en-US أو sr-Latn

TimeZone

يمثّل منطقة زمنية من قاعدة بيانات المناطق الزمنية في IANA.

تمثيل JSON
{
  "id": string,
  "version": string
}
الحقول
id

string

المنطقة الزمنية في قاعدة بيانات المناطق الزمنية IANA، مثل "America/New_York"

version

string

اختياريّ. رقم إصدار قاعدة بيانات المناطق الزمنية IANA، مثل "2019a"

الطُرق

createAndConfigure

يتم إنشاء حساب مستقل على Merchant Center مع إعدادات إضافية.

delete

لحذف الحساب المحدّد بغض النظر عن نوعه: حساب مستقل أو حساب متعدّد العملاء أو حساب فرعي

get

استرداد حساب من حسابك على Merchant Center

list

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

listSubaccounts

إدراج جميع الحسابات الفرعية لحساب متعدّد العملاء معيّن

patch

تعديل حساب بغض النظر عن نوعه: حساب مستقل أو حساب متعدّد العملاء أو حساب فرعي