Method: organizations.findSalesPartnerManagedClients

Gibt eine Liste der von der Vertriebspartnerorganisation verwalteten Kunden zurück.

Der Nutzer muss ein Organisationsadministrator oder Abrechnungsadministrator in der Organisation des Vertriebspartners sein, um die Endkunden aufrufen zu können.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
organization

string

Erforderlich. Der Name der Organisation des Vertriebspartners. Format: organizations/{org_id}

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "isActive": boolean
}
Felder
isActive

boolean

Optional. Wenn festgelegt, werden nur aktive und gerade beendete Clients zurückgegeben.

Antworttext

Antwortnachricht für den RPC „organizations.findSalesPartnerManagedClients“.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung
{
  "clientData": [
    {
      object (ClientData)
    }
  ]
}
Felder
clientData[]

object (ClientData)

Die von der Vertriebsorganisation verwalteten Kunden.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

ClientData

Enthält die Clientdaten.

JSON-Darstellung
{
  "organization": {
    object (Organization)
  },
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
Felder
organization

object (Organization)

Der Endkunde, der einen Vertrag mit der angeforderten Vertriebsorganisation hat oder hatte.

startDate

object (Date)

Das Startdatum des Vertrags zwischen der Vertriebsorganisation und dem Endkunden.

endDate

object (Date)

Das Enddatum des Vertrags zwischen der Vertriebsorganisation und dem Endkunden.

Datum

Stellt ein ganzes Kalenderdatum oder einen Teil davon dar, z. B. einen Geburtstag. Die Uhrzeit und die Zeitzone werden entweder an einer anderen Stelle angegeben oder sind nicht relevant. Das Datum wird relativ zum gregorianischen Kalender angegeben. Das kann Folgendes darstellen:

  • Ein vollständiges Datum mit Werten für Jahr, Monat und Tag, die nicht 0 sind.
  • Einen Monat und einen Tag mit einem Jahr von 0 (z. B. ein Jahrestag).
  • Ein Jahr für sich, mit einem Monat und einem Tag von 0.
  • Ein Jahr und ein Monat mit einem Tag von 0, z. B. ein Ablaufdatum der Kreditkarte.

Ähnliche Typen:

JSON-Darstellung
{
  "year": integer,
  "month": integer,
  "day": integer
}
Felder
year

integer

Jahr des Datums. Muss zwischen 1 und 9999 liegen oder kann 0 sein, wenn ein Datum ohne Jahresangabe angegeben wird.

month

integer

Monat eines Jahres. Die Angabe muss zwischen 1 und 12 liegen. Sie kann auch 0 sein, wenn ein Jahr ohne Monat und Tag angegeben wird.

day

integer

Tag des Monats. Die Angabe muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein. Sie kann auch 0 sein, wenn das Jahr bzw. der Monat angegeben wird, der Tag selbst jedoch nicht von Belang ist.