REST Resource: accounts.programs

المرجع: البرنامج

تحدِّد المشاركة في برنامج معيّن للحساب المحدّد.

توفّر البرامج آلية لإضافة وظائف إلى حسابات التجار. ومن الأمثلة الشائعة على ذلك برنامج البيانات المجانية للمنتجات الذي يتيح عرض المنتجات من متجر التاجر على مختلف خدمات Google مجانًا.

تمثيل JSON 
{
  "name": string,
  "documentationUri": string,
  "state": enum (State),
  "activeRegionCodes": [
    string
  ],
  "unmetRequirements": [
    {
      object (Requirement)
    }
  ]
}
الحقول
name

string

المعرّف اسم المورد الخاص بالبرنامج التنسيق: accounts/{account}/programs/{program}
documentationUri

string

النتائج فقط. عنوان URL لصفحة مساعدة في Merchant Center توضّح البرنامج
state

enum (State)

النتائج فقط. حالة مشاركة الحساب في البرنامج.
activeRegionCodes[]

string

النتائج فقط. المناطق التي يشارك فيها الحساب بنشاط في البرنامج يتم تعريف المناطق النشطة على أنّها المناطق التي تم استيفاء جميع متطلبات البرنامج التي تؤثر فيها.

يتم تحديد رموز المناطق من خلال CLDR. يشير هذا الحقل إلى بلد ينطبق فيه البرنامج على وجه التحديد أو 001 عندما ينطبق البرنامج على مستوى العالم.
unmetRequirements[]

object (Requirement)

النتائج فقط. المتطلبات التي لم يستوفِها الحساب بعد والتي تؤثّر في المشاركة في البرنامج

الحالة

حالات المشاركة المحتملة في البرنامج للحساب

عمليات التعداد
STATE_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
NOT_ELIGIBLE الحساب غير مؤهَّل للمشاركة في البرنامج.
ELIGIBLE أن يكون الحساب مؤهلاً للمشاركة في البرنامج
ENABLED تم تفعيل البرنامج للحساب.

المطلوب للحصول على الشارة

تُحدِّد متطلّبًا محدّدًا للمشاركة في البرنامج.

تمثيل JSON 
{
  "title": string,
  "documentationUri": string,
  "affectedRegionCodes": [
    string
  ]
}
الحقول
title

string

النتائج فقط. اسم الشرط
documentationUri

string

النتائج فقط. عنوان URL لصفحة مساعدة توضّح الشرط
affectedRegionCodes[]

string

النتائج فقط. المناطق المتأثّرة حاليًا بعدم استيفاء هذا الشرط

يتم تحديد رموز المناطق من خلال CLDR. يشير هذا الحقل إلى بلد ينطبق فيه البرنامج على وجه التحديد أو 001 عندما ينطبق البرنامج على مستوى العالم.

الطُرق

disable

 إيقاف المشاركة في البرنامج المحدّد للحساب

enable

 فعِّل المشاركة في البرنامج المحدّد للحساب.

get

 يسترجع البرنامج المحدّد للحساب.

list

 يسترجع جميع البرامج للحساب.