Objeto de Dados UserInvitation - Gestão de Clientes
Define um convite para um utilizador se inscrever no Microsoft Advertising. O convite limita o acesso e as permissões da conta.
Importante
Quando o convite é enviado, pode optar por limitar o acesso dos utilizadores a um subconjunto de contas de anunciantes diretamente sob o seu cliente. Se uma hierarquia de agências estiver configurada (agora ou no futuro) no cliente onde o utilizador é convidado e se não limitar o acesso a contas específicas, o utilizador terá acesso a todas as contas na hierarquia.
É possível que sejam enviados vários convites pendentes para o mesmo endereço de e-mail, que ainda não expiraram. Também é possível que esses convites tenham especificado diferentes funções de utilizador, por exemplo, se enviou um convite com uma função de utilizador incorreta e, em seguida, enviou um segundo convite com a função de utilizador correta. O destinatário pode aceitar qualquer um dos convites e pode inscrever-se com credenciais diferentes do endereço de e-mail do convite. Os utilizadores do Microsoft Advertising podem aceitar convites para vários clientes com as mesmas credenciais. Para obter mais informações, veja o guia técnico Credenciais multiutilizador .
Pode procurar convites pendentes por ID de convite e saber se o convite foi aceite ou expirou. A operação SearchUserInvitations devolve todos os convites pendentes, quer tenham expirado ou não. Os convites aceites não estão incluídos na resposta SearchUserInvitations .
Depois de o convite ter sido aceite, pode ligar para GetUsersInfo e GetUser para aceder aos detalhes do utilizador do Microsoft Advertising. No entanto, uma vez que um destinatário pode aceitar o convite e inscrever-se com credenciais diferentes do endereço de e-mail de convite, não pode determinar com certeza o mapeamento de um objeto UserInvitation para um utilizador ou userInfo . Com o ID de utilizador devolvido por GetUsersInfo ou GetUser, pode chamar DeleteUser para remover o utilizador conforme necessário. A API de Anúncios do Bing não suporta operações para eliminar convites de utilizador pendentes. Depois de convidar um utilizador, a única forma de cancelar o convite é através da aplicação Web Microsoft Advertising. Pode encontrar convites pendentes e aceites na secção Utilizadores de Contas & Faturação.
Sintaxe
<xs:complexType name="UserInvitation" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:sequence>
<xs:element minOccurs="0" name="Id" type="xs:long" />
<xs:element minOccurs="0" name="FirstName" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="LastName" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="Email" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="CustomerId" type="xs:long" />
<xs:element minOccurs="0" name="RoleId" type="xs:int" />
<xs:element xmlns:q5="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="AccountIds" nillable="true" type="q5:ArrayOflong" />
<xs:element minOccurs="0" name="ExpirationDate" type="xs:dateTime" />
<xs:element minOccurs="0" name="Lcid" type="tns:LCID" />
</xs:sequence>
</xs:complexType>
Elementos
O objeto UserInvitation tem os seguintes elementos: AccountIds, CustomerId, Email, ExpirationDate, FirstName, Id, LastName, Lcid, RoleId.
| Elemento | Descrição | Tipo de Dados |
|---|---|---|
| AccountIds | Uma matriz de identificadores das contas que o utilizador pode gerir. Para especificar que o utilizador pode gerir todas as contas atuais e futuras do cliente a que o utilizador pertence, defina como NULL. Os utilizadores com funções ao nível da conta, como o Gestor de Campanha do Anunciante, podem ser restringidos a contas específicas. Os utilizadores com funções ao nível do cliente, como o Super Administração, podem aceder a todas as contas dentro do cliente do utilizador e o respetivo acesso não pode ser restringido a contas específicas. Ao tentar restringir as funções de utilizador ao nível do cliente, por exemplo, ao tentar restringir um Super Administração a contas específicas, a operação não falhará e será concedido ao utilizador acesso a todas as contas dentro do cliente especificado. Enviar: Opcional Inscrição: Opcional |
matriz longa |
| CustomerId | O identificador do cliente que este utilizador está convidado a gerir. O elemento AccountIds determina quais as contas de cliente que o utilizador pode gerir. Enviar: Necessário Inscrição: Só de leitura |
Longo |
| O endereço de e-mail correspondente à conta Microsoft do utilizador. O endereço pode conter um máximo de 100 carateres. Enviar: Necessário Inscrição: Necessário |
cadeia | |
| ExpirationDate | A data e hora em que o convite do utilizador irá expirar. O valor está em Hora Universal Coordenada (UTC). A duração de um convite de utilizador está sujeita a alterações e está atualmente definida para 30 dias. Não é possível definir ou atualizar este valor. Enviar: Só de leitura Inscrição: Só de leitura |
dateTime |
| NomePróprio | O primeiro nome do utilizador. O nome próprio está limitado a 40 carateres. Enviar: Necessário Inscrição: Necessário |
cadeia |
| ID | Um identificador exclusivo gerado pelo sistema para o convite de utilizador. Enviar: Só de leitura Inscrição: Só de leitura |
Longo |
| Apelido | O apelido do utilizador. O apelido está limitado a 40 carateres. Enviar: Necessário Inscrição: Necessário |
cadeia |
| Lcid | A região a utilizar ao enviar correspondência ao utilizador por e-mail ou correio postal. A predefinição é EnglishUS. Enviar: Necessário Inscrição: Necessário |
LCID |
| RoleId | A função que o utilizador tem para cada cliente ou lista de contas. 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 . Enviar: Necessário Inscrição: Necessário. O ID da função tem de ser definido como 41 ou 203. |
int |
Requisitos
Serviço: CustomerManagementService.svc v13
Espaço de nomes: https://bingads.microsoft.com/Customer/v13/Entities