- Solicitud HTTP
- Parámetros de ruta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- ClientData
- Fecha
- Pruébalo
Devuelve una lista de los clientes que administra la organización del socio de ventas.
El usuario debe ser administrador de la organización o administrador de facturación de la organización del socio de ventas para ver los clientes finales.
Solicitud HTTP
POST https://marketingplatformadmin.googleapis.com/v1alpha/{organization=organizations/*}:findSalesPartnerManagedClients
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros | |
|---|---|
organization |
Obligatorio. Es el nombre de la organización del socio de ventas. Formato: organizations/{org_id} |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
| Representación JSON |
|---|
{ "isActive": boolean } |
| Campos | |
|---|---|
isActive |
Opcional. Si se configura, solo se devolverán los clientes activos y los que acaban de finalizar. |
Cuerpo de la respuesta
Es el mensaje de respuesta para la RPC de organizations.findSalesPartnerManagedClients.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
| Representación JSON |
|---|
{
"clientData": [
{
object ( |
| Campos | |
|---|---|
clientData[] |
Son los clientes que administra la organización de ventas. |
Permisos de autorización
Se necesita uno de los siguientes permisos de OAuth:
https://www.googleapis.com/auth/marketingplatformadmin.analytics.readhttps://www.googleapis.com/auth/marketingplatformadmin.analytics.update
ClientData
Contiene los datos del cliente.
| Representación JSON |
|---|
{ "organization": { object ( |
| Campos | |
|---|---|
organization |
Es el cliente final que tiene o tuvo un contrato con la organización de ventas solicitada. |
startDate |
Es la fecha de inicio del contrato entre la organización de ventas y el cliente final. |
endDate |
Es la fecha de finalización del contrato entre la organización de ventas y el cliente final. |
Fecha
Representa una fecha de calendario completa o parcial, como un cumpleaños. La hora del día y la zona horaria se especifican en otro lugar o son insignificantes. La fecha está relacionada con el calendario gregoriano. Puede representar una de las siguientes opciones:
- Una fecha completa con valores para el año, mes y día que no sean cero.
- Un mes y un día, con cero año (por ejemplo, un aniversario).
- Un año por sí solo, con un mes cero y un día cero.
- Es un año y un mes, con un día cero (por ejemplo, la fecha de vencimiento de una tarjeta de crédito).
Tipos relacionados:
google.type.TimeOfDaygoogle.type.DateTimegoogle.protobuf.Timestamp
| Representación JSON |
|---|
{ "year": integer, "month": integer, "day": integer } |
| Campos | |
|---|---|
year |
Año de la fecha. Debe ser entre 1 y 9,999, o bien 0 para especificar una fecha sin año. |
month |
Mes del año. Debe ser del 1 al 12 o 0 para especificar un año sin un mes ni un día. |
day |
Día del mes. Debe ser entre 1 y 31 y ser válido para el año y el mes o bien 0 para especificar un año solo o un año y un mes en los que el día no sea significativo. |