Method: organizations.findSalesPartnerManagedClients

تعرض هذه الطريقة قائمة بالعملاء الذين تديرهم مؤسسة شريك المبيعات.

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

طلب HTTP

POST https://marketingplatformadmin.googleapis.com/v1alpha/{organization=organizations/*}:findSalesPartnerManagedClients

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات المسار

المعلمات
organization

string

الحقل مطلوب. تمثّل هذه السمة اسم مؤسسة شريك المبيعات. التنسيق: organizations/{org_id}

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "isActive": boolean
}
الحقول
isActive

boolean

اختيارية: في حال ضبط هذا الخيار، سيتم عرض العملاء النشطين والعملاء الذين انتهت اشتراكاتهم مؤخرًا فقط.

نص الاستجابة

رسالة الرد على إجراء طلب RPC الخاص بـ organizations.findSalesPartnerManagedClients

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "clientData": [
    {
      object (ClientData)
    }
  ]
}
الحقول
clientData[]

object (ClientData)

العملاء الذين تديرهم مؤسسة المبيعات

نطاقات الأذونات

يجب توفير أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/marketingplatformadmin.analytics.read
  • https://www.googleapis.com/auth/marketingplatformadmin.analytics.update

ClientData

يحتوي على بيانات العميل.

تمثيل JSON 
{
  "organization": {
    object (Organization)
  },
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
الحقول
organization

object (Organization)

العميل النهائي الذي لديه/كان لديه عقد مع مؤسسة المبيعات المطلوبة
startDate

object (Date)

تمثّل هذه السمة تاريخ بدء العقد بين المؤسسة المسؤولة عن المبيعات والعميل النهائي.
endDate

object (Date)

تمثّل هذه السمة تاريخ انتهاء العقد بين المؤسسة المسؤولة عن المبيعات والعميل النهائي.

التاريخ

تمثّل هذه السمة تاريخ تقويم كاملاً أو جزئيًا، مثل تاريخ الميلاد. يتم تحديد الوقت من اليوم والمنطقة الزمنية في مكان آخر أو لا أهمية لهما. التاريخ نسبي بالنسبة إلى التقويم الغريغوري. يمكن أن يمثّل ذلك أحد ما يلي:

  • تاريخ كامل، مع قيم غير صفرية للسنة والشهر واليوم
  • الشهر واليوم، مع سنة صفر (على سبيل المثال، ذكرى سنوية)
  • سنة بمفردها، مع شهر ويوم بقيمة صفر
  • سنة وشهر، مع يوم صفر (على سبيل المثال، تاريخ انتهاء صلاحية بطاقة ائتمان).

الأنواع ذات الصلة:

تمثيل JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
الحقول
year

integer

سنة التاريخ يجب أن يكون الرقم بين 1 و9999، أو 0 لتحديد تاريخ بدون سنة.
month

integer

الشهر من السنة يجب أن يكون الرقم بين 1 و12، أو 0 لتحديد سنة بدون شهر ويوم.
day

integer

اليوم من الشهر يجب أن يكون الرقم بين 1 و31 وصالحًا للسنة والشهر، أو 0 لتحديد سنة بمفردها أو سنة وشهر لا يكون فيه اليوم مهمًا.