- درخواست HTTP
- پارامترهای مسیر
- درخواست بدنه
- بدنه پاسخ
- دامنههای مجوز
- دادههای کلاینت
- تاریخ
- امتحانش کن!
لیستی از مشتریانی را که توسط سازمان شریک فروش مدیریت میشوند، برمیگرداند.
برای مشاهده مشتریان نهایی، کاربر باید در سازمان همکار فروش، مدیر اجرایی/مدیر صورتحساب باشد.
درخواست HTTP
POST https://marketingplatformadmin.googleapis.com/v1alpha/{organization=organizations/*}:findSalesPartnerManagedClients
این URL از سینتکس Transcoding در gRPC استفاده میکند.
پارامترهای مسیر
| پارامترها | |
|---|---|
organization | الزامی. نام سازمان همکار فروش. فرمت: organizations/{org_id} |
درخواست بدنه
بدنه درخواست شامل دادههایی با ساختار زیر است:
| نمایش JSON |
|---|
{ "isActive": boolean } |
| فیلدها | |
|---|---|
isActive | اختیاری. در صورت تنظیم، فقط کلاینتهای فعال و تازه پایانیافته بازگردانده میشوند. |
بدنه پاسخ
پیام پاسخ برای organizations.findSalesPartnerManagedClients RPC.
در صورت موفقیت، بدنه پاسخ شامل دادههایی با ساختار زیر است:
| نمایش JSON |
|---|
{
"clientData": [
{
object ( |
| فیلدها | |
|---|---|
clientData[] | مشتریانی که توسط سازمان فروش مدیریت میشوند. |
دامنههای مجوز
به یکی از حوزههای OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/marketingplatformadmin.analytics.read -
https://www.googleapis.com/auth/marketingplatformadmin.analytics.update
دادههای کلاینت
شامل دادههای کلاینت است.
| نمایش JSON |
|---|
{ "organization": { object ( |
| فیلدها | |
|---|---|
organization | مشتری نهایی که با سازمان فروش مورد درخواست قرارداد دارد/داشته است. |
startDate | تاریخ شروع قرارداد بین سازمان فروش و مشتری نهایی. |
endDate | تاریخ پایان قرارداد بین سازمان فروش و مشتری نهایی. |
تاریخ
نشان دهنده یک تاریخ تقویمی کامل یا جزئی، مانند تاریخ تولد است. زمان روز و منطقه زمانی یا در جای دیگری مشخص شدهاند یا اهمیت چندانی ندارند. تاریخ نسبت به تقویم میلادی است. این میتواند یکی از موارد زیر را نشان دهد:
- یک تاریخ کامل، با مقادیر سال، ماه و روز غیر صفر.
- یک ماه و یک روز، با یک سال صفر (مثلاً یک سالگرد).
- یک سال به تنهایی، با یک ماه صفر و یک روز صفر.
- یک سال و یک ماه، با یک روز صفر (برای مثال، تاریخ انقضای کارت اعتباری).
انواع مرتبط:
-
google.type.TimeOfDay -
google.type.DateTime -
google.protobuf.Timestamp
| نمایش JSON |
|---|
{ "year": integer, "month": integer, "day": integer } |
| فیلدها | |
|---|---|
year | سال تاریخ. باید از ۱ تا ۹۹۹۹ باشد، یا برای مشخص کردن تاریخ بدون سال، ۰ باشد. |
month | ماه سال. باید از ۱ تا ۱۲ باشد، یا برای مشخص کردن سال بدون ماه و روز، ۰ باشد. |
day | روز ماه. باید از ۱ تا ۳۱ باشد و برای سال و ماه معتبر باشد، یا ۰ برای مشخص کردن یک سال به تنهایی یا یک سال و ماه که روز در آن مهم نیست. |