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

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

إطلاق أولي لخدمة LoyaltyPrograms التي يمكنك استخدامها لإدارة برامج الولاء تتوفّر هذه الميزة فقط لتجّار محدّدين. لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على برامج الولاء.

الأسبوع الذي يبدأ في 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

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