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

الأسبوع الذي يبدأ في 3 أغسطس 2026

  • تمت إضافة "ucp_checkout_management" كنوع خدمة إلى مورد خدمة الحساب. ملاحظة: الدفع عبر بروتوكول UCP هو ميزة متاحة بشكل محدود.
  • تمّت إضافة دعم لبرنامج "ucp-integration" (وصول محدود).
  • تمّت إضافة إمكانية استخدام نوع بنود الخدمة "ucp_integration".

الأسبوع الذي يبدأ في 29 يونيو 2026

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

  • أضفنا youtube-affiliate إلى قائمة أسماء البرامج المتاحة في وصف المرجع accounts.programs.
  • تفعيل واجهة برمجة التطبيقات الخاصة بالبرنامج في "برنامج التسويق بالعمولة من منصّة التسوّق على YouTube" متوفّر للمختبِرين الموثوق بهم

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

  • تمت إضافة الحالة WAITING إلى "حالة الموافقة". بالنسبة إلى خدمات مقارنة الأسعار (CSS)، تمثّل الحالة WAITING حالة انتقالية بين PENDING وESTABLISHED. يتم استخدامها عندما تحتاج خدمة CSS الأصلية إلى وقت لإجراء أي عملية تنظيف ضرورية قبل نقل الحساب بالكامل إلى خدمة CSS الجديدة.

الأسبوع الذي يبدأ في 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 الذي يتيح لمستخدمي واجهة برمجة التطبيقات إنشاء 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

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