CustomerRole Data Object – Kundenverwaltung
Definiert Kontozugriffsrechte für eine Person, die im Namen eines bestimmten Kunden handelt.
Eine Person kann die gleichen Anmeldeinformationen verwenden, um auf Konten für mehrere Kunden zuzugreifen, und mehrere CustomerRole-Objekte können für eine Person über den GetUser-Vorgang zurückgegeben werden. Beispielsweise werden zwei CustomerRole-Objekte zurückgegeben, wenn user@contoso.com zu Customer 123 eingeladen wurde und der Benutzer auch Zugriff zum Verwalten verknüpfter Konten unter Customer 234 hat.
Einzeln betrachtet, hat ein Benutzer dieselbe Rolle für die CustomerId, AccountIds und LinkedAccountIds für einen bestimmten CustomerRole. Wenn ein Benutzer jedoch über mehrere Kundenrollen verfügt, hängen die effektiven Berechtigungen von dem vollständigen Satz von CustomerRoles ab, der von GetUser zurückgegeben wird. Im Folgenden finden Sie einige Beispiele.
Tipp
Eine Übersicht über Kundenrollen mit Beispielen finden Sie im Leitfaden zu Konto-Hierchy- und Benutzerberechtigungen .
<xs:complexType name="CustomerRole" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:sequence>
<xs:element minOccurs="0" name="RoleId" type="xs:int" />
<xs:element minOccurs="0" name="CustomerId" type="xs:long" />
<xs:element xmlns:q7="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="AccountIds" nillable="true" type="q7:ArrayOflong" />
<xs:element xmlns:q8="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="LinkedAccountIds" nillable="true" type="q8:ArrayOflong" />
<xs:element minOccurs="0" name="CustomerLinkPermission" nillable="true" type="xs:string" />
</xs:sequence>
</xs:complexType>
Elemente
Das CustomerRole-Objekt weist die folgenden Elemente auf: AccountIds, CustomerId, CustomerLinkPermission, LinkedAccountIds, RoleId.
| Element | Beschreibung | Datentyp |
|---|---|---|
| AccountIds | Die Liste der Konten, auf die der Benutzer im Kunden zugreifen kann. Wenn der Benutzer über die CID-Zugriffsebene verfügt, werden AccountIDs nicht zurückgegeben. Für den Zugriff auf Kontoebene werden die AccountIDs im CustomerRole-Objekt der GetUser-API zurückgegeben. |
langes Array |
| CustomerId | Der Bezeichner des Kunden, bei dem sich der Benutzer entweder registriert hat oder über eine Kontohierarchiebeziehung verfügt. | lang |
| CustomerLinkPermission | Bestimmt, ob der Zugriff des Benutzers auf die Konten durch die Kundenhierarchie eingeschränkt wird, d. h. die Clientverknüpfung auf Kundenebene. Mögliche Werte sind Administrative, Standard und LinkedEntityOnly. Es ist auch möglich, dass dieses Feld null oder leer sein kann. Wenn dieses Feld null oder leer ist, wird der Benutzer direkt bei der CustomerId registriert. Wenn dieses Feld auf "Administrator" festgelegt ist, hat der Benutzer über einen Administratorkundenlink Zugriff auf die CustomerId. Wenn dieses Feld auf "Standard" festgelegt ist, hat der Benutzer über einen Standard Kundenlink Zugriff auf die CustomerId. Wenn dieses Feld auf "LinkedEntityOnly" festgelegt ist, wird der Benutzer direkt bei der CustomerId registriert, kann aber nicht auf seine Werbekundenkonten zugreifen. Die CustomerId ist Teil einer Kundenlinkhierarchie , in der der Benutzer auf andere Kunden darunter zugreifen kann. Weitere Informationen finden Sie im technischen Leitfaden zu Benutzerrollen . |
Zeichenfolge |
| LinkedAccountIds | Die Liste der verknüpften Konten, auf die der Benutzer über die CustomerId als Agentur im Namen eines anderen Kunden zugreifen kann. Wenn dieses Element null ist, hat der Benutzer keinen Zugriff auf einzeln verknüpfte Werbekundenkonten über die CustomerId. Der Benutzer hat möglicherweise Zugriff auf Werbekundenkonten in anderen verknüpften Kunden. Berücksichtigen Sie daher unbedingt alle CustomerRoles , die von GetUser zurückgegeben werden. Beachten Sie, dass Konten, die als Aggregator über SignupCustomer erstellt wurden, auch in diesem Element zurückgegeben werden. Sie können aggregierte Konten über DeleteAccount löschen, aber Sie können die Verknüpfung nicht über UpdateClientLinks aufheben. Rufen Sie den SearchClientLinks-Vorgang auf, um zu ermitteln, welche Konten entfernt werden können. |
langes Array |
| RoleId | Die Rolle, die der Benutzer beim Zugriff auf Werbekundenkonten über die CustomerId hat. Mögliche Werte: 16 – Der Benutzer verfügt über die Rolle "Advertiser Campaign Manager ". 33 – Der Benutzer verfügt über die Aggregatorrolle . 41 – Der Benutzer hat die Rolle Super Admin. 100 : Der Benutzer verfügt über die Rolle "Viewer ". 203 – Der Benutzer verfügt über die Rolle Standard Benutzer. Weitere Informationen finden Sie im technischen Leitfaden zu Benutzerrollen . |
int |
Anforderungen
Service: CustomerManagementService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13/Entities