Operazione del servizio UpdateUserRoles - Gestione clienti

Aggiornamenti i ruoli dell'utente specificato.

Nota

Solo un utente con credenziali Super Amministrazione o Standard può aggiornare i ruoli utente. Un utente Standard non può impostare o modificare il ruolo Super Amministrazione. Per altre informazioni, vedere la Guida tecnica per i ruoli utente .

Per gli utenti con un ruolo account, è possibile aggiungere ed eliminare gli account a cui l'utente ha accesso. Per gli utenti con un ruolo cliente, è possibile aggiungere ed eliminare i clienti a cui l'utente ha accesso. È anche possibile modificare un utente dall'avere un ruolo account ad avere un ruolo cliente o viceversa.

Elementi della richiesta

L'oggetto UpdateUserRolesRequest definisce il corpo e gli elementi dell'intestazione della richiesta di operazione del servizio. Gli elementi devono essere nello stesso ordine indicato nella richiesta SOAP.

Nota

Se non diversamente indicato di seguito, sono necessari tutti gli elementi della richiesta.

Elementi del corpo della richiesta

Elemento	Descrizione	Tipo di dati
Customerid	Identificatore del cliente a cui appartiene l'utente.	long
DeleteAccountIds	Matrice di identificatori degli account da rimuovere dall'elenco di account che l'utente può gestire. Per informazioni sull'utilizzo, vedere la sezione Osservazioni riportata di seguito.	matrice long
DeleteCustomerIds	Matrice di identificatori dei clienti da rimuovere dall'elenco dei clienti che l'utente può gestire. Per informazioni sull'utilizzo, vedere la sezione Osservazioni riportata di seguito.	matrice long
DeleteRoleId	Identificatore del ruolo a cui si applicano i valori specificati nell'elemento DeleteAccountIds o DeleteCustomerIds , se impostato. 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 . Importante: l'elenco precedente fornisce esempi di possibili valori restituiti. Potrebbero essere restituiti altri valori. I ruoli deprecati o interni possono essere inclusi nella risposta.	int
NewAccountIds	Matrice di identificatori degli account a cui limitare l'utente. L'utente sarà in grado di gestire solo questi account. Se l'utente è attualmente limitato a un set di account, impostare questo elemento sui nuovi account che l'utente deve gestire. Ad esempio, se l'utente gestisce attualmente gli account 123 e 456 e si vuole che l'utente gestirà anche l'account 789, impostare questo elemento su 789. Per informazioni sull'utilizzo, vedere la sezione Osservazioni riportata di seguito.	matrice long
NewCustomerIds	Matrice di identificatori dei clienti a cui limitare l'utente. L'utente sarà in grado di gestire solo questi clienti. Per informazioni sull'utilizzo, vedere la sezione Osservazioni riportata di seguito.	matrice long
NewRoleId	Identificatore del ruolo a cui si applicano i valori specificati nell'elemento NewAccountIds o NewCustomerIds , se impostato. 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 . Importante: l'elenco precedente fornisce esempi di possibili valori restituiti. Potrebbero essere restituiti altri valori. I ruoli deprecati o interni possono essere inclusi nella risposta.	int
UserId	Identificatore dell'utente di cui si vuole aggiornare il ruolo.	long

Elementi dell'intestazione della richiesta

Elemento	Descrizione	Tipo di dati
AuthenticationToken	Token di accesso OAuth che rappresenta le credenziali di un utente che dispone delle autorizzazioni per gli account Microsoft Advertising. Per altre informazioni, vedere Autenticazione con OAuth.	Stringa
DeveloperToken	Token di sviluppo usato per accedere all'API Bing Ads. Per altre informazioni, vedere Ottenere un token per sviluppatori.	Stringa
Password	Questo elemento è riservato per l'uso interno e verrà rimosso da una versione futura dell'API. È necessario usare l'elemento AuthenticationToken per impostare le credenziali utente.	Stringa
UserName	Questo elemento è riservato per l'uso interno e verrà rimosso da una versione futura dell'API. È necessario usare l'elemento AuthenticationToken per impostare le credenziali utente.	Stringa

Elementi di risposta

L'oggetto UpdateUserRolesResponse definisce gli elementi corpo e intestazione della risposta dell'operazione del servizio. Gli elementi vengono restituiti nello stesso ordine illustrato nella soap di risposta.

Elementi del corpo della risposta

Elemento	Descrizione	Tipo di dati
LastModifiedTime	Data e ora dell'ultimo aggiornamento dei ruoli utente. Il valore è espresso nell'ora UTC (Coordinated Universal Time). Il valore di data e ora riflette la data e l'ora nel server, non nel client. Per informazioni sul formato della data e dell'ora, vedere la voce dateTime in Tipi di dati XML primitivi.	Datetime

Elementi dell'intestazione della risposta

Elemento	Descrizione	Tipo di dati
TrackingId	Identificatore della voce di log che contiene i dettagli della chiamata API.	Stringa

Richiedi SOAP

Questo modello è stato generato da uno strumento per visualizzare l'ordine degli elementi corpo e intestazione per la richiesta SOAP. Per i tipi supportati che è possibile usare con questa operazione del servizio, vedere il riferimento Request Body Elements sopra riportato.

<s:Envelope xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/Customer/v13">
    <Action mustUnderstand="1">UpdateUserRoles</Action>
    <AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
    <DeveloperToken i:nil="false">ValueHere</DeveloperToken>
  </s:Header>
  <s:Body>
    <UpdateUserRolesRequest xmlns="https://bingads.microsoft.com/Customer/v13">
      <CustomerId>ValueHere</CustomerId>
      <UserId>ValueHere</UserId>
      <NewRoleId i:nil="false">ValueHere</NewRoleId>
      <NewAccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <a1:long>ValueHere</a1:long>
      </NewAccountIds>
      <NewCustomerIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <a1:long>ValueHere</a1:long>
      </NewCustomerIds>
      <DeleteRoleId i:nil="false">ValueHere</DeleteRoleId>
      <DeleteAccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <a1:long>ValueHere</a1:long>
      </DeleteAccountIds>
      <DeleteCustomerIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <a1:long>ValueHere</a1:long>
      </DeleteCustomerIds>
    </UpdateUserRolesRequest>
  </s:Body>
</s:Envelope>

SOAP della risposta

Questo modello è stato generato da uno strumento per visualizzare l'ordine degli elementi del corpo e dell'intestazione per la risposta SOAP.

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/Customer/v13">
    <TrackingId d3p1:nil="false" xmlns:d3p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</TrackingId>
  </s:Header>
  <s:Body>
    <UpdateUserRolesResponse xmlns="https://bingads.microsoft.com/Customer/v13">
      <LastModifiedTime>ValueHere</LastModifiedTime>
    </UpdateUserRolesResponse>
  </s:Body>
</s:Envelope>

Sintassi del codice

La sintassi di esempio può essere usata con gli SDK di Bing Ads. Per altri esempi, vedere Esempi di codice DELL'API Bing Ads .

public async Task<UpdateUserRolesResponse> UpdateUserRolesAsync(
	long customerId,
	long userId,
	int? newRoleId,
	IList<long> newAccountIds,
	IList<long> newCustomerIds,
	int? deleteRoleId,
	IList<long> deleteAccountIds,
	IList<long> deleteCustomerIds)
{
	var request = new UpdateUserRolesRequest
	{
		CustomerId = customerId,
		UserId = userId,
		NewRoleId = newRoleId,
		NewAccountIds = newAccountIds,
		NewCustomerIds = newCustomerIds,
		DeleteRoleId = deleteRoleId,
		DeleteAccountIds = deleteAccountIds,
		DeleteCustomerIds = deleteCustomerIds
	};

	return (await CustomerManagementService.CallAsync((s, r) => s.UpdateUserRolesAsync(r), request));
}

static UpdateUserRolesResponse updateUserRoles(
	java.lang.Long customerId,
	java.lang.Long userId,
	int newRoleId,
	ArrayOflong newAccountIds,
	ArrayOflong newCustomerIds,
	int deleteRoleId,
	ArrayOflong deleteAccountIds,
	ArrayOflong deleteCustomerIds) throws RemoteException, Exception
{
	UpdateUserRolesRequest request = new UpdateUserRolesRequest();

	request.setCustomerId(customerId);
	request.setUserId(userId);
	request.setNewRoleId(newRoleId);
	request.setNewAccountIds(newAccountIds);
	request.setNewCustomerIds(newCustomerIds);
	request.setDeleteRoleId(deleteRoleId);
	request.setDeleteAccountIds(deleteAccountIds);
	request.setDeleteCustomerIds(deleteCustomerIds);

	return CustomerManagementService.getService().updateUserRoles(request);
}

static function UpdateUserRoles(
	$customerId,
	$userId,
	$newRoleId,
	$newAccountIds,
	$newCustomerIds,
	$deleteRoleId,
	$deleteAccountIds,
	$deleteCustomerIds)
{

	$GLOBALS['Proxy'] = $GLOBALS['CustomerManagementProxy'];

	$request = new UpdateUserRolesRequest();

	$request->CustomerId = $customerId;
	$request->UserId = $userId;
	$request->NewRoleId = $newRoleId;
	$request->NewAccountIds = $newAccountIds;
	$request->NewCustomerIds = $newCustomerIds;
	$request->DeleteRoleId = $deleteRoleId;
	$request->DeleteAccountIds = $deleteAccountIds;
	$request->DeleteCustomerIds = $deleteCustomerIds;

	return $GLOBALS['CustomerManagementProxy']->GetService()->UpdateUserRoles($request);
}

response=customermanagement_service.UpdateUserRoles(
	CustomerId=CustomerId,
	UserId=UserId,
	NewRoleId=NewRoleId,
	NewAccountIds=NewAccountIds,
	NewCustomerIds=NewCustomerIds,
	DeleteRoleId=DeleteRoleId,
	DeleteAccountIds=DeleteAccountIds,
	DeleteCustomerIds=DeleteCustomerIds)

Osservazioni

Come esempio di caso d'uso se un gestore di campagne pubblicitarie è limitato alla gestione degli account 123, 456 e 789 e non si vuole più che l'utente gestirà 456, impostare gli elementi seguenti di conseguenza:

• Impostare l'elemento NewRoleId su 16 (ruolo di gestore della campagna pubblicitaria).

• Impostare l'elemento NewAccountIds su una matrice contenente 123 e 789.

• Impostare l'elemento DeleteRoleId su 16 (ruolo di gestore della campagna pubblicitaria).

• Impostare l'elemento DeleteAccountIds su una matrice contenente 456.

Se un gestore di campagne pubblicitarie è limitato alla gestione degli account 123 e 789 e ora vuoi che l'utente gestisa tutti gli account, imposta gli elementi seguenti di conseguenza:

• Impostare l'elemento NewRoleId su 16 (ruolo di gestore della campagna pubblicitaria).

• Impostare l'elemento NewAccountIds su NULL.

• Impostare l'elemento DeleteRoleId su 16 (ruolo di gestore della campagna pubblicitaria).

• Impostare l'elemento DeleteAccountIds su una matrice contenente 123, 456 e 789.

Gli utenti con ruoli a livello di account possono essere limitati a account specifici. Gli utenti con ruoli a livello di cliente possono accedere a tutti gli account all'interno del cliente dell'utente e il loro accesso non può essere limitato a account specifici.

Nota

Quando si tenta di limitare i ruoli utente a livello di cliente a account specifici, l'operazione UpdateUserRoles non avrà esito negativo e l'utente manterrà l'accesso per tutti gli account all'interno del cliente dell'utente.

Requisiti

Servizio: CustomerManagementService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13