Oggetto dati CustomerRole - Customer Management
Definisce i diritti di accesso all'account per una persona che agisce per conto di un cliente specifico.
Una persona può usare le stesse credenziali di accesso per accedere agli account di più clienti e più oggetti CustomerRole possono essere restituiti per una persona tramite l'operazione GetUser . Ad esempio, vengono restituiti due oggetti CustomerRole se user@contoso.com è stato invitato a Customer 123 e l'utente ha anche accesso per gestire gli account collegati in Customer 234.
Preso singolarmente, un utente ha lo stesso ruolo in CustomerId, AccountIds e LinkedAccountIds per un determinato CustomerRole; Tuttavia, se un utente ha più ruoli cliente, le autorizzazioni effettive dipendono dall'intero set di CustomerRoles restituito da GetUser. Di seguito sono riportati alcuni esempi.
Consiglio
Per una panoramica dei ruoli dei clienti con esempi, vedere la Guida alle autorizzazioni utente e hierchy dell'account .
Sintassi
<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>
Elementi
L'oggetto CustomerRole include gli elementi seguenti: AccountIds, CustomerId, CustomerLinkPermission, LinkedAccountIds, RoleId.
| Elemento | Descrizione | Tipo di dati |
|---|---|---|
| AccountIds | Elenco di account a cui l'utente può accedere nel cliente. Se l'utente dispone del livello di accesso CID, gli ACCOUNTID non verranno restituiti. Per l'accesso a livello di account, gli ID account verranno restituiti nell'oggetto CustomerRole dell'API GetUser. |
matrice long |
| Customerid | Identificatore del cliente in cui l'utente ha effettuato l'iscrizione o ha una relazione di gerarchia dell'account . | long |
| CustomerLinkPermission | Determina se l'accesso dell'utente agli account è limitato dalla gerarchia dei clienti, ad esempio dal collegamento client a livello di cliente. I valori possibili includono Administrative, Standard e LinkedEntityOnly. È anche possibile che questo campo sia nil o vuoto. Se questo campo è nil o vuoto, l'utente viene registrato direttamente in CustomerId. Se questo campo è impostato su "Amministrativo", l'utente ha accesso al CustomerId tramite un collegamento al cliente amministrativo. Se questo campo è impostato su "Standard", l'utente ha accesso al CustomerId tramite un collegamento cliente Standard. Se questo campo è impostato su "LinkedEntityOnly", l'utente viene registrato direttamente in CustomerId ma non può accedere agli account dell'inserzionista. CustomerId fa parte di una gerarchia di collegamenti del cliente in base alla quale l'utente può accedere ad altri clienti sottostanti. Per altre informazioni, vedere la Guida tecnica per i ruoli utente . |
Stringa |
| LinkedAccountIds | Elenco di account collegati a cui l'utente può accedere tramite CustomerId come agenzia per conto di un altro cliente. Se questo elemento è nil, l'utente non ha accesso agli account dell'inserzionista collegati singolarmente tramite CustomerId. L'utente potrebbe avere accesso agli account dell'inserzionista in altri clienti collegati, quindi assicurati di prendere in considerazione tutti i CustomerRoles restituiti da GetUser. Si noti che anche gli account creati come aggregatore tramite SignupCustomer verranno restituiti in questo elemento. È possibile eliminare account aggregati tramite DeleteAccount, ma non è possibile scollegarli tramite UpdateClientLinks. Chiamare l'operazione SearchClientLinks per determinare quali account possono essere scollegati. |
matrice long |
| Roleid | Ruolo dell'utente quando accede agli account dell'inserzionista tramite CustomerId. I valori possibili includono: 16 - L'utente ha il ruolo Advertiser Campaign Manager . 33 - L'utente ha il ruolo Aggregatore . 41 - L'utente ha il ruolo Super Amministrazione. 100 - L'utente ha il ruolo Visualizzatore . 203 - L'utente ha il ruolo Utente Standard . Per altre informazioni, vedere la Guida tecnica per i ruoli utente . |
int |
Requisiti
Servizio: CustomerManagementService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13/Entities