ملاحظات إصدار واجهة برمجة التطبيقات لحسابات التجار

الأسبوع الذي يبدأ في 16 مارس 2026

  • تم إطلاق طريقة CreateTestAccount في Accounts API. يتيح ذلك للمطوّرين إنشاء حسابات اختبار مخصّصة آليًا تعمل في بيئة معزولة تشبه وضع الحماية، ما يوفّر مساحة آمنة لتطوير عمليات الدمج واختبارها.

الأسبوع الذي يبدأ في 17 نوفمبر 2025

  • تقدّم CreateAndConfigureAccountRequest الآن خدمات جديدة يمكن إعدادها أثناء عملية إعداد الحساب. يجب تحديد قيمة واحدة فقط من AccountAggregation وAccountManagement وComparisonShopping. بالإضافة إلى ذلك، يمكن تحديد عدد عشوائي من خدمات ProductsManagement وCampaignsManagement. ومع ذلك، يجب ألا تتشابه أي خدمتَين في مقدّم الخدمة ومعرّفات الحسابات الخارجية.

  • توفّر طريقة AccountsService.CreateAndConfigure الآن إعدادًا للتحكّم في ما إذا كان سيتم إرسال رسالة تأكيد عبر البريد الإلكتروني.

  • يتضمّن CreateAndConfigureAccountRequest.AddAccountService الآن الحقل external_account_id (يتوفّر هذا الحقل حاليًا في المورد AccountService). يمكن تحديدها مع خدمات CampaignsManagement وProductsManagement.

  • تمت إضافة خدمة ComparisonShopping إلى المرجع AccountService. يمكنك الاطّلاع على https://support.google.com/merchants/answer/12653197 لمزيد من التفاصيل.

  • يمكنك الآن ضبط اسم مستعار لعلاقة أثناء إنشاء حساب باستخدام الحقل setAlias في CreateAndConfigureAccountRequest.

  • تمت إضافة طريقة VerifySelf إلى UserService تتيح تعديل الحالة من PENDING إلى VERIFIED للمورد User الذي يمثّل المستخدم الذي يجري الاتصال.

  • إطلاق الحقل الجديد radius_area في حمولة Region لواجهة برمجة التطبيقات Regions API التي ستتيح للتجّار إنشاء منطقة باستخدام مساحة نصف القطر

الأسبوع الذي يبدأ في 10 نوفمبر 2025

  • نشر الإصدار v1alpha من Services API
  • إطلاق الحقل الجديد product_filters في حمولة CampaignManagement ضمن Services API، ما يتيح للتجّار مشاركة مجموعة فرعية فقط من خلاصتهم مع حسابات "إعلانات Google"، وذلك استنادًا إلى بعض عمليات الفلترة الشرطية على سمات منتجات التاجر هذه الميزة متاحة فقط للتجّار المدرَجين في القائمة المسموح بها.

الأسبوع الذي يبدأ في 25 أغسطس 2025

  • تمت إضافة طرق مجمّعة جديدة إلى Regions API:
    • BatchCreateRegions: تتيح إنشاء مناطق متعدّدة في طلب واحد.
    • ‫BatchUpdateRegions: تتيح تعديل مناطق متعددة في طلب واحد.
    • ‫BatchDeleteRegions: تتيح هذه الطريقة حذف مناطق متعدّدة حسب الاسم في طلب واحد.

الأسبوع الذي يبدأ في 1 يوليو 2025

  • إطلاق المرجع CheckoutSettings الذي يتيح لمستخدمي واجهة برمجة التطبيقات إنشاء إعدادات الدفع وتعديلها وحذفها والحصول عليها

الأسبوع الذي يبدأ في 26 مايو 2025

  • يمكن الآن فلترة الحسابات حسب capabilities. القيمة الوحيدة المتاحة حاليًا هي CAN_UPLOAD_PRODUCTS. يتيح لك هذا الفلتر استرداد الحسابات التي يمكنها تحميل المنتجات. وهذا يعني أنّه يمكن الآن استخدام العبارات التالية على مستوى الحساب:

    • capabilities:CAN_UPLOAD_PRODUCTS
    • -capabilities:CAN_UPLOAD_PRODUCTS
    • NOT capabilities:CAN_UPLOAD_PRODUCTS لمزيد من المعلومات، اطّلِع على دليل الفلترة.

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

الأسبوع الذي يبدأ في 19 مايو 2025

  • تم تعديل المستندات الخاصة بواجهة برمجة التطبيقات الخاصة بالبرنامج، وتمت إزالة العبارة غير الصحيحة التي تفيد بأنّ طرق Enable/Disable محصورة بالمستخدمين المشرفين.

الأسبوع الذي يبدأ في 12 مايو 2025

  • إطلاق مرجع "سياسة الإرجاع على الإنترنت" الذي يتيح لمستخدمي واجهة برمجة التطبيقات إنشاء سياسات الإرجاع وتعديلها وحذفها
  • إطلاق OmnichannelSettingsService ومورد OmnichannelSetting الذي يتيح لمستخدمي واجهة برمجة التطبيقات إدارة تجربة قناة التسويق الشاملة
  • إطلاق LfpProvidersService ومورد LfpProvider الذي يتيح لمستخدمي واجهة برمجة التطبيقات إدارة علاقة الشراكة في "خلاصات محلية"
  • إطلاق GbpAccountsService ومورد GbpAccount الذي يتيح لمستخدمي واجهة برمجة التطبيقات إدارة ملفاتهم التجارية على Google.
  • إطلاق نوع الخدمة LocalListingManagement في AccountService، والذي يربط مجموعة فروع المؤسسة المستخدَمة في "إعلانات للمنتجات المتوفرة في المتجر" أو "البيانات المحلية المجانية".

الأسبوع الذي يبدأ في 28 أبريل 2025

  • إطلاق موردَي AccountService وAccountRelationship اللذين يتيحان لمستخدمي واجهة برمجة التطبيقات إدارة العلاقات وإنشاء خدمات لمقدّمي الخدمات

الأسبوع الذي يبدأ في 14 أبريل 2025

  • تعرض الدالة TermsOfServiceService.AcceptTermsOfService الآن TermsOfServiceAgremeentState الذي تم قبوله مضمّنًا في نوع ردّ.

  • أصبح فعل الإجراء TermsOfServiceService.AcceptTermsOfService الآن POST (كان في السابق GET).

  • أوضحنا أنّه يجب استدعاء AccountsService.ListSubAccounts باستخدام التنسيق accounts/... (بدلاً من providers/...)، وذلك لتجنُّب خروج هذه الطريقة من نطاق accounts (أي GET accounts/123:listSubAccounts بدلاً من GET providers/123:listSubAccounts).

الأسبوع الذي يبدأ في 31 مارس 2025

  • بالنسبة إلى فلترة الحسابات، تم الإعلان عن إيقاف فلتر externalAccountId نهائيًا في الأسبوع الذي يبدأ في 2 كانون الأول (ديسمبر) 2024، وهو غير متوفّر الآن. وهذا يعني أنّه يمكن الآن الفلترة حسب externalAccountId على مستوى service فقط. لن يعمل فلتر مثل relationship(externalAccountId = "foo")، ويجب التعبير عنه بالشكل relationship(service(externalAccountId = "foo")).

  • تم توضيح في مستندات AccountsService أنّه لا يمكن إنشاء حسابات مستقلة.

الأسبوع الذي يبدأ في 3 مارس 2025

-تمت إعادة تصميم accounts.onlineReturnPolicies#SeasonalOverride لتحسين الوضوح والاتساق. تشمل هذه التحديثات ما يلي:

  • إعادة تسمية الحقول:
    • ‫begin أصبح الآن start_date.
    • ‫end أصبح الآن end_date.
  • إزالة الحقل:
    • تمت إزالة الحقل policy الذي تم إيقافه نهائيًا.

-على المطوّرين تعديل الرمز البرمجي ليتضمّن هذه التغييرات.

إطلاق خدمة AutomaticImprovements التي يمكنك استخدامها لإدارة ما يلي:

لمزيد من المعلومات، راجِع تفعيل التحسينات التلقائية.

الأسبوع الذي يبدأ في 17 فبراير 2025

تمت إزالة المسند callerHasAccessToProviderFilter() من فلتر الحساب.

الأسبوع الذي يبدأ في 10 فبراير 2025

  • تحسين المستندات الخاصة بطريقة AccountsService.List تعرض هذه الطريقة جميع الحسابات التي يمكن للمستخدم الوصول إليها، وليس الحسابات المستقلة فقط.

  • تمت إضافة مهلة تلقائية مدتها 10 دقائق لجميع طرق RPC.

  • تمت إضافة قائمة بأسماء البرامج المتاحة إلى وصف المورد accounts.programs.

  • أصبح User.accessRights الآن REQUIRED، ما يؤثّر في الطريقتَين UserService.Create وAccountsService.CreateAndConfigure.

الأسبوع الذي يبدأ في 27 يناير 2025

تعرض الطريقتان AccountsService.ListAccounts (وAccountsService.ListSubAccounts بشكل متعدٍّ) الآن الحسابات بطريقة متسقة في النهاية بدلاً من أن تكونا قراءة قوية.

الأسبوع الذي يبدأ في 20 يناير 2025

تم إيقاف الحقل users الخاص بـ CreateAndConfigureAccountRequest نهائيًا واستبداله بحقل user جديد. يحتوي CreateUserRequest الذي تمت الإشارة إليه على الحقل parent غير المطلوب في سياق CreateAndConfigureAccountRequest.

الأسبوع الذي يبدأ في 6 يناير 2025

تم الآن وضع علامة OPTIONAL على الحقل user في الرسالة CreateUserRequest بشكل صحيح.

تم الآن ملء الحقل domain في الأخطاء التي تم إرجاعها بالقيمة merchantapi.googleapis.com بدلاً من global

الأسبوع الذي يبدأ في 2 ديسمبر 2024

لتصفية الحسابات، يتم نقل المسند externalAccountId إلى مستوى service من مستوى relationship. لذا، يجب الآن كتابة الفلتر relationship(externalAccountId = "foo") على النحو relationship(service(externalAccountId = "foo")). لا يزال التنسيق القديم متاحًا لضمان التوافق مع الأنظمة القديمة، ولكنّه سيصبح متوقّفًا نهائيًا وسيؤدي إلى طرح خطأ في المستقبل القريب. ستشير جميع المستندات إلى التنسيق الجديد فقط.

الأسبوع الذي يبدأ في 18 نوفمبر 2024

يمكن أن يكون مقدّم الخدمة في الحقل CreateAndConfigureAccountRequest.service.provider أحد providers/GOOGLE_ADS أو providers/GOOGLE_BUSINESS_PROFILE. يجب الإشارة إلى الحسابات الأخرى باسم providers/123 (بدلاً من accounts/123)، ما يعني أنّه لم يعُد يتم وضع تعليق توضيحي على الحقل كمرجع حساب. ومع ذلك، لا يزال من الممكن استخدام أسماء حسابات مثل accounts/123 لضمان التوافق مع الأنظمة القديمة.

يجب أن يكون الموفّر في ListSubAccountsRequest الآن بالشكل providers/123، ولكن سيظل من الممكن استخدام accounts/123 للتوافق مع الأنظمة القديمة.

الأسبوع الذي يبدأ في 4 نوفمبر 2024

وضع علامة promotions_consent REQUIRED (من OPTIONAL) في المرجع BusinessIdentity يؤثّر ذلك في طريقة التحديث فقط. نودّ أن نوضّح أنّه لا يمكن تعديل التصنيف من promotions_consent إلى UNSPECIFIED. لم يكن ذلك ممكنًا من قبل، ولكن أصبح الخطأ الآن أكثر وصفًا وتمت إضافة التعليقات التوضيحية إلى الحقل بشكل صحيح.

الأسبوع الذي يبدأ في 28 أكتوبر 2024

تحسين مستندات الموارد المختلفة لواجهة برمجة التطبيقات الفرعية "الحسابات"، مثل User وHomepage وBusinessInfo وما إلى ذلك

الأسبوع الذي يبدأ في 21 أكتوبر 2024

تحسين مستندات حقول update_mask في طلبات التعديل لتوضيح الحقول التي يمكن تعديلها

تمت إضافة رابط إلى "مركز مساعدة نشاطي التجاري على Google" لمشغّلي شبكات الجوَّال المؤهَّلين إلى المستند الخارجي الخاص بمورد ShippingSettings

الأسبوع الذي يبدأ في 14 أكتوبر 2024

وضع علامة provider كـ REQUIRED في AccountsService.CreateAndConfigureAccountRequest.AddAccountService

جعل update_mask اختياريًا في جميع أنحاء واجهة برمجة التطبيقات الفرعية للحسابات (مثل هوية النشاط التجاري ومعلومات النشاط التجاري والصفحة الرئيسية وما إلى ذلك) وبشكل رجعي للمورد ConversionSources

تمت إضافة المَعلمة overwrite إلى ClaimHomepageRequest.

الأسبوع الذي يبدأ في 30 سبتمبر 2024

إطلاق المَعلمة "force" للطريقة "Accounts.delete"

الأسبوع الذي يبدأ في 23 سبتمبر 2024

ضَع علامة REQUIRED على region_code وkind في RetrieveLatestTermsOfServiceRequest.

الأسبوع الذي يبدأ في 16 سبتمبر 2024

تم تغيير نوع المَعلمة time_zone إلى سلسلة في ListAccountIssuesRequest

الأسبوع الذي يبدأ في 12 أغسطس 2024

تمت إضافة الحقل korean_business_registration_number إلى المرجع BusinessInfo.

الأسبوع الذي يبدأ في 27 مايو 2024

إطلاق الإصدار التجريبي من واجهة برمجة التطبيقات الفرعية للحسابات