UpdateUserRoles Service Operation – Gestão de Clientes

Artigo
12/21/2023

Atualizações as funções do utilizador especificado.

Nota

Apenas um utilizador com credenciais Super Administração ou Standard pode atualizar as funções de utilizador. Um utilizador Standard não pode definir ou modificar a função Super Administração. Para obter mais informações, veja o Guia técnico das Funções de Utilizador .

Para utilizadores com uma função de conta, pode adicionar e eliminar as contas às quais o utilizador tem acesso. Para utilizadores com uma função de cliente, pode adicionar e eliminar os clientes aos quais o utilizador tem acesso. Também pode alterar um utilizador de ter uma função de conta para ter uma função de cliente ou vice-versa.

Elementos do Pedido

O objeto UpdateUserRolesRequest define os elementos do corpo e do cabeçalho do pedido de operação do serviço. Os elementos têm de estar na mesma ordem mostrada no Pedido SOAP.

Nota

Salvo indicação em contrário abaixo, todos os elementos do pedido são necessários.

Elementos do Corpo do Pedido

Elemento	Descrição	Tipo de Dados
CustomerId	O identificador do cliente ao qual o utilizador pertence.	long
DeleteAccountIds	Uma matriz de identificadores das contas a remover da lista de contas que o utilizador pode gerir. Para utilização, veja a secção Observações abaixo.	matriz longa
DeleteCustomerIds	Uma matriz de identificadores dos clientes a remover da lista de clientes que o utilizador pode gerir. Para utilização, veja a secção Observações abaixo.	matriz longa
DeleteRoleId	O identificador da função à qual se aplicam os valores especificados no elemento DeleteAccountIds ou DeleteCustomerIds , se definido. Os valores possíveis incluem o seguinte: 16 - O utilizador tem a função Gestor de Campanha do Anunciante . 33 - O utilizador tem a função Agregador . 41 - O utilizador tem a função Super Administração. 100 - O utilizador tem a função Visualizador . 203 - O utilizador tem a função Utilizador Padrão . Para obter mais informações, veja o Guia técnico das Funções de Utilizador . Importante: a lista acima fornece exemplos de possíveis valores devolvidos. Podem ser devolvidos outros valores. As funções preteridas ou internas podem ser incluídas na resposta.	int
NewAccountIds	Uma matriz de identificadores das contas para restringir o utilizador. O utilizador só poderá gerir estas contas. Se o utilizador estiver atualmente restrito a um conjunto de contas, defina este elemento para as novas contas que pretende que o utilizador também faça a gestão. Por exemplo, se o utilizador gerir atualmente as contas 123 e 456 e pretender que o utilizador também faça a gestão da conta 789, defina este elemento como 789. Para utilização, veja a secção Observações abaixo.	matriz longa
NewCustomerIds	Uma matriz de identificadores dos clientes para restringir o utilizador. O utilizador poderá gerir apenas estes clientes. Para utilização, veja a secção Observações abaixo.	matriz longa
NewRoleId	O identificador da função à qual se aplicam os valores especificados no elemento NewAccountIds ou NewCustomerIds , se definido. Os valores possíveis incluem o seguinte: 16 - O utilizador tem a função Gestor de Campanha do Anunciante . 33 - O utilizador tem a função Agregador . 41 - O utilizador tem a função Super Administração. 100 - O utilizador tem a função Visualizador . 203 - O utilizador tem a função Utilizador Padrão . Para obter mais informações, veja o Guia técnico das Funções de Utilizador . Importante: a lista acima fornece exemplos de possíveis valores devolvidos. Podem ser devolvidos outros valores. As funções preteridas ou internas podem ser incluídas na resposta.	int
UserId	O identificador do utilizador cuja função pretende atualizar.	long

Elementos do Cabeçalho do Pedido

Elemento	Descrição	Tipo de Dados
AuthenticationToken	O token de acesso OAuth que representa as credenciais de um utilizador que tem permissões para contas do Microsoft Advertising. Para obter mais informações, veja Authentication with OAuth (Autenticação com OAuth).	cadeia
DeveloperToken	O token de programador utilizado para aceder à API de Anúncios do Bing. Para obter mais informações, veja Obter um Token de Programador.	cadeia
Palavra-passe	Este elemento está reservado para utilização interna e será removido de uma versão futura da API. Tem de utilizar o elemento AuthenticationToken para definir credenciais de utilizador.	cadeia
Nome de Utilizador	Este elemento está reservado para utilização interna e será removido de uma versão futura da API. Tem de utilizar o elemento AuthenticationToken para definir credenciais de utilizador.	cadeia

Elementos de Resposta

O objeto UpdateUserRolesResponse define os elementos do corpo e do cabeçalho da resposta da operação do serviço. Os elementos são devolvidos pela mesma ordem mostrada no SOAP de Resposta.

Elementos do Corpo da Resposta

Elemento	Descrição	Tipo de Dados
LastModifiedTime	A data e hora em que as funções de utilizador foram atualizadas pela última vez. O valor está em Hora Universal Coordenada (UTC). O valor de data e hora reflete a data e hora no servidor, não o cliente. Para obter informações sobre o formato da data e hora, veja a entrada dateTime em Tipos de Dados XML Primitivos.	dateTime

Elementos do Cabeçalho de Resposta

Elemento	Descrição	Tipo de Dados
TrackingId	O identificador da entrada de registo que contém os detalhes da chamada à API.	cadeia

Pedir SOAP

Este modelo foi gerado por uma ferramenta para mostrar a ordem dos elementos do corpo e do cabeçalho do pedido SOAP. Para tipos suportados que pode utilizar com esta operação de serviço, veja a referência Request Body Elements (Elementos do Corpo do Pedido ) acima.

<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 de Resposta

Este modelo foi gerado por uma ferramenta para mostrar a ordem dos elementos do corpo e do cabeçalho para a resposta 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>

Sintaxe de Código

A sintaxe de exemplo pode ser utilizada com os SDKs de Anúncios do Bing. Veja Exemplos de Código da API de Anúncios do Bing para obter mais exemplos.

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)

Observações

Como caso de utilização de exemplo, se um gestor de campanha de anunciantes estiver limitado à gestão das contas 123, 456 e 789 e já não quiser que o utilizador faça a gestão 456, defina os seguintes elementos em conformidade:

Defina o elemento NewRoleId como 16 (função de gestor de campanha de anunciantes).
Defina o elemento NewAccountIds como uma matriz que contém 123 e 789.
Defina o elemento DeleteRoleId como 16 (função de gestor de campanha de anunciantes).
Defina o elemento DeleteAccountIds como uma matriz que contém 456.

Se um gestor de campanha de anunciantes estiver limitado à gestão das contas 123 e 789 e pretender que o utilizador faça a gestão de todas as contas, defina os seguintes elementos em conformidade:

Defina o elemento NewRoleId como 16 (função de gestor de campanha de anunciantes).
Defina o elemento NewAccountIds como NULL.
Defina o elemento DeleteRoleId como 16 (função de gestor de campanha de anunciantes).
Defina o elemento DeleteAccountIds como uma matriz que contém 123, 456 e 789.

Os utilizadores com funções ao nível da conta podem ser restringidos a contas específicas. Os utilizadores com funções ao nível do cliente podem aceder a todas as contas no cliente do utilizador e o respetivo acesso não pode ser restringido a contas específicas.

Nota

Ao tentar restringir as funções de utilizador ao nível do cliente a contas específicas, a operação UpdateUserRoles não falhará e o utilizador manterá o acesso a todas as contas dentro do cliente do utilizador.

Requisitos

Serviço: CustomerManagementService.svc v13
Espaço de nomes: https://bingads.microsoft.com/Customer/v13

Compartilhar via

UpdateUserRoles Service Operation – Gestão de Clientes

Elementos do Pedido

Elementos do Corpo do Pedido

Elementos do Cabeçalho do Pedido

Elementos de Resposta

Elementos do Corpo da Resposta

Elementos do Cabeçalho de Resposta

Pedir SOAP

Soap de Resposta

Sintaxe de Código

Observações

Requisitos

Comentários

Recursos adicionais