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

الأسبوع الذي يبدأ في 26 أكتوبر 2026

  • تم توضيح المستندات الخاصة بطريقة accounts.homepage.unclaim والحقل claimed في المورد Homepage. إذا كان الحساب يرث المطالبة بالصفحة الرئيسية من حسابه بامتيازات متقدّمة، ستعرض السمة unclaim ردًا ناجحًا، ولكن ستبقى الصفحة الرئيسية خاضعة للمطالبة. إذا كان الحساب نفسه معفيًا من المطالبة، يعرض unclaim الخطأ FAILED_PRECONDITION.

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

  • تمت إضافة youtube_affiliate_management كنوع خدمة إلى المورد AccountService في v1alpha. ملاحظة: ميزة "إدارة شركاء YouTube التابعين" متاحة بشكل محدود.

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

  • تمت إضافة حقل home_page_uri للقراءة فقط إلى مورد accounts لعرض معرّف الموارد المنتظم (URI) للصفحة الرئيسية للمتجر.

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

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

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

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

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

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

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

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

يتم الآن ملء الحقل 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 Business لمشغّلي شبكات الجوّال المتوافقين إلى المستند الخارجي لمورد ShippingSettings

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

وضع علامة "REQUIRED" على "provider" في AccountsService.CreateAndConfigureAccountRequest.AddAccountService

Make update_mask optional throughout Accounts sub-API (e.g. business identity, business information, homepage etc.) and retroactively for the ConversionSources resource.

تمت إضافة المَعلمة "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

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