傳回銷售合作夥伴機構管理的客戶清單。
使用者必須是銷售合作夥伴機構的機構管理員/帳單管理員,才能查看終端客戶。
HTTP 要求
POST https://marketingplatformadmin.googleapis.com/v1alpha/{organization=organizations/*}:findSalesPartnerManagedClients
這個網址使用 gRPC 轉碼語法。
路徑參數
| 參數 | |
|---|---|
organization |
必要欄位。銷售合作夥伴機構的名稱。格式:organizations/{org_id} |
要求主體
要求主體會包含結構如下的資料:
| JSON 表示法 |
|---|
{ "isActive": boolean } |
| 欄位 | |
|---|---|
isActive |
(選用步驟) 如果設定此參數,系統只會傳回有效和剛結束的用戶端。 |
回應主體
organizations.findSalesPartnerManagedClients RPC 的回應訊息。
如果成功,回應主體會含有以下結構的資料:
| JSON 表示法 |
|---|
{
"clientData": [
{
object ( |
| 欄位 | |
|---|---|
clientData[] |
銷售機構管理的客戶。 |
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/marketingplatformadmin.analytics.readhttps://www.googleapis.com/auth/marketingplatformadmin.analytics.update
ClientData
包含用戶端資料。
| JSON 表示法 |
|---|
{ "organization": { object ( |
| 欄位 | |
|---|---|
organization |
與所要求銷售機構有/曾有合約的最終客戶。 |
startDate |
銷售機構與終端客戶之間的合約開始日期。 |
endDate |
銷售機構與終端客戶之間的合約結束日期。 |
日期
表示完整或部分的日曆日期,例如生日。您可以視重要性決定是否要在別處指定時段和時區。日期以公曆為主,這可以代表下列其中一項:
- 完整日期,具有非零的年、月和日值。
- 月和日,年值為零 (例如週年紀念日)。
- 只有年,月和日值為零。
- 年和月,日值為零 (例如信用卡到期日)。
相關類型:
google.type.TimeOfDaygoogle.type.DateTimegoogle.protobuf.Timestamp
| JSON 表示法 |
|---|
{ "year": integer, "month": integer, "day": integer } |
| 欄位 | |
|---|---|
year |
日期年份。必須為 1 到 9999;如要指定不含年份的日期,請輸入 0。 |
month |
一年中的月份。必須為 1 到 12;如要指定不含日期的年份,請輸入 0。 |
day |
當月第幾日。必須為 1 到 31,並屬於有效的年和月;如果只指定年份,或只指定年份和月份,而不指定當月第幾日的話,請輸入 0。 |