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

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

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

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

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

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

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

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

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

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

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

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

تم تحسين مستندات الحقول update_mask في طلبات التعديل في كل مكان للإشارة تحديدًا إلى الحقول التي يمكن تعديلها.

تمت إضافة رابط مركز مساعدة Google للأعمال إلى المستند الخارجي لمورد ShippingSettings بالنسبة إلى شركات النقل المتاحة

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

تم وضع علامة REQUIRED على provider في 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

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