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

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

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