CRM-Hilfe

getUsers-Methode

Zweck

Mit der getUsers-Methode können Sie die Liste der Benutzer in Ihrem Unternehmen abrufen.

Anfrage-URL

XML-Format:
https://crm.zoho.com/crm/private/xml/Users/getUsers?authtoken=Auth Token&scope=crmapi&type=The Type of User

JSON-Format:
https://crm.zoho.com/crm/private/json/Users/getUsers?authtoken=Auth Token&scope=crmapi&type=The Type of User

Anfrageparameter

ParameterDatentypBeschreibung
authtoken*ZeichenfolgeVerschlüsselte alphanumerische Zeichenfolge zur Authentifizierung Ihrer Zoho-Anmeldedaten.
scope*ZeichenfolgeGeben Sie den Wert als crmapi an.
newFormatGanzzahlnewFormat=1: Um Felder mit dem Wert "Null" beim Einfügen von Daten aus Ihrem CRM-Konto auszuschließen.
newFormat=2: Um Felder mit dem Wert "Null" beim Einfügen von Daten aus Ihrem CRM-Konto einzubeziehen.
versionGanzzahlVersion = 1: (Standardwert) Dadurch werden Antworten auf der Grundlage der früheren API-Implementierung abgerufen, d. h. vor den vorgenommenen Erweiterungen/Verbesserungen.
Version = 2: Dadurch werden Antworten basierend auf der neuesten API-Implementierung abgerufen.
type*ZeichenfolgeDieser Parameter kann einen der folgenden Werte annehmen:
AllUsers
Es werden alle Benutzer in Ihrem Unternehmen (sowohl aktive als auch inaktive Benutzer) aufgelistet.
ActiveUsers
Es werden alle aktiven Benutzer aufgelistet. 
DeactiveUsers
Es werden alle deaktivierten Benutzer aufgelistet.
AdminUsers
Es werden alle Benutzer mit Administratorrechten aufgelistet.
ActiveConfirmedAdmins
Es werden alle Benutzer aufgelistet, die bestätigt sind und über Administratorrechte verfügen.

* – Obligatorischer Parameter

Hinweis:

  • Auf der Seite Versionshinweise erfahren Sie mehr über die Erweiterungen/Verbesserungen, die in der API-Implementierung vorgenommen wurden.

Beispielantwort

Geben Sie in diesem Fall = AllUsers ein.

<users>
   <user id="501240000000541313" email="andrew@zohocorp.com" role="CEO" profile="Administrator" status="active" confirm="true">andrew</user>
   <user id="501234132412341135" email="tyson@zohocorp.com" role="Manager" profile="Standard" status="active" confirm="true">tyson</user>
   <user id="501234565431234521" email="kelly@zohocorp.com" role="Manager" profile="Standard" status="active" confirm="false">kelly</user>
   <user id="512343454676898643" email="frank@zohocorp.com" role="CEO" profile="Standard" status="active" confirm="false">frank</user>
   <user id="512445678909865545" email="sophia@zohocorp.com" role="CEO" profile="Administrator" status="active" confirm="true">sophia</user>
</users>

Wenn version=2, erhalten Sie die Org-ID in der Antwort. Um die Org-ID in der Antwort zu erhalten, müssten jedoch die Unternehmensdetails in Ihren CRM-Datensätzen verfügbar sein.

<users orgid="501240000000652982">
   <user id="501240000000541313" zuid="11381966" website="null" mobile="888-555-2146" fax="null" street="null" city="null" state="null" country="null" zip="null" language="en_US" timezone="PST8PDT" email="andrew@zohocorp.com" role="CEO" profile="Administrator" status="active" confirm="true">andrew</user>
   <user id="512445678909865545" zuid="11385946" website="null" mobile="null" fax="null" street="null" city="null" state="null" country="null" zip="null" language="en_US" timezone="America/Los_Angeles" email="sophia@zohocorp.com" role="CEO" profile="Administrator" status="active" confirm="true">sophia</user>
</users>

Share this post : FacebookTwitter

Finden Sie immer noch nicht, wonach Sie suchen?

Schreib uns: support@zohocrm.com