Objet de données UserInvitation - Gestion des clients
Définit une invitation pour un utilisateur à s’inscrire à Microsoft Advertising. L’invitation limite l’accès au compte et les autorisations.
Importante
Lorsque l’invitation est envoyée, vous pouvez choisir de limiter l’accès utilisateur à un sous-ensemble de comptes d’annonceur qui se trouvent directement sous votre client. Si une hiérarchie d’agence est configurée (maintenant ou à l’avenir) sous le client où l’utilisateur est invité, et si vous ne limitez pas l’accès à des comptes spécifiques, l’utilisateur a accès à tous les comptes de la hiérarchie.
Il est possible que plusieurs invitations en attente soient envoyées à la même adresse e-mail, qui n’ont pas encore expiré. Il est également possible que ces invitations aient spécifié différents rôles d’utilisateur, par exemple si vous avez envoyé une invitation avec un rôle d’utilisateur incorrect, puis envoyé une deuxième invitation avec le rôle d’utilisateur approprié. Le destinataire peut accepter les invitations et s’inscrire avec des informations d’identification différentes de l’adresse e-mail de l’invitation. Les utilisateurs de Microsoft Advertising peuvent accepter des invitations à plusieurs clients avec les mêmes informations d’identification. Pour plus d’informations, consultez le guide technique des informations d’identification multi-utilisateur .
Vous pouvez rechercher les invitations en attente par ID d’invitation et déterminer si l’invitation a été acceptée ou a expiré. L’opération SearchUserInvitations retourne toutes les invitations en attente, qu’elles aient expiré ou non. Les invitations acceptées ne sont pas incluses dans la réponse SearchUserInvitations .
Une fois l’invitation acceptée, vous pouvez appeler GetUsersInfo et GetUser pour accéder aux détails de l’utilisateur Microsoft Advertising. Toutefois, étant donné qu’un destinataire peut accepter l’invitation et s’inscrire avec des informations d’identification différentes de l’adresse e-mail de l’invitation, vous ne pouvez pas déterminer avec certitude le mappage d’un UserInvitation à un objet User Ou UserInfo . Avec l’ID utilisateur retourné par GetUsersInfo ou GetUser, vous pouvez appeler DeleteUser pour supprimer l’utilisateur si nécessaire. L’API Bing Ads ne prend pas en charge les opérations de suppression des invitations utilisateur en attente. Une fois que vous avez invité un utilisateur, la seule façon d’annuler l’invitation est de passer par l’application web Microsoft Advertising. Vous trouverez les invitations en attente et acceptées dans la section Utilisateurs de Comptes & Facturation.
Syntaxe
<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>
Éléments
L’objet UserInvitation a les éléments suivants : AccountIds, CustomerId, Email, ExpirationDate, FirstName, Id, LastName, Lcid, RoleId.
| Élément | Description | Type de données |
|---|---|---|
| Id de compte | Tableau d’identificateurs des comptes que l’utilisateur peut gérer. Pour spécifier que l’utilisateur peut gérer tous les comptes actuels et futurs du client auquel appartient l’utilisateur, définissez sur NULL. Les utilisateurs disposant de rôles au niveau du compte, tels que Le Gestionnaire de campagnes de l’annonceur, peuvent être limités à des comptes spécifiques. Les utilisateurs disposant de rôles de niveau client tels que Super Administration peuvent accéder à tous les comptes au sein du client de l’utilisateur, et leur accès ne peut pas être limité à des comptes spécifiques. Lorsque vous tentez de restreindre les rôles d’utilisateur au niveau du client, par exemple en tentant de restreindre un Super Administration à des comptes spécifiques, l’opération n’échouera pas et l’utilisateur se verra accorder l’accès à tous les comptes au sein du client spécifié. Envoyer: Optionnel Inscription: Optionnel |
tableau long |
| Customerid | Identificateur du client que cet utilisateur est invité à gérer.
L’élément AccountIds détermine les comptes clients que l’utilisateur peut gérer. Envoyer: Obligatoire Inscription: En lecture seule |
Long |
| Courrier électronique | Adresse e-mail correspondant au compte Microsoft de l’utilisateur. L’adresse peut contenir un maximum de 100 caractères. Envoyer: Obligatoire Inscription: Obligatoire |
chaîne |
| ExpirationDate | Date et heure d’expiration de l’invitation de l’utilisateur. La valeur est exprimée au format UTC (temps universel coordonné). La durée d’une invitation d’utilisateur est susceptible d’être modifiée et est actuellement définie sur 30 jours. Vous ne pouvez pas définir ou mettre à jour cette valeur. Envoyer: En lecture seule Inscription: En lecture seule |
dateTime |
| FirstName | Prénom de l’utilisateur. Le prénom est limité à 40 caractères. Envoyer: Obligatoire Inscription: Obligatoire |
chaîne |
| ID | Identificateur unique généré par le système pour l’invitation de l’utilisateur. Envoyer: En lecture seule Inscription: En lecture seule |
Long |
| LastName | Nom de l’utilisateur. Le nom est limité à 40 caractères. Envoyer: Obligatoire Inscription: Obligatoire |
chaîne |
| Lcid | Paramètres régionaux à utiliser lors de l’envoi de la correspondance à l’utilisateur par courrier électronique ou postal. La valeur par défaut est EnglishUS. Envoyer: Obligatoire Inscription: Obligatoire |
LCID |
| RoleId | Rôle que l’utilisateur a pour chaque client ou liste de comptes. Les valeurs possibles sont les suivantes : 16 - L’utilisateur a le rôle Gestionnaire de campagne de l’annonceur . 33 - L’utilisateur a le rôle Agrégateur . 41 - L’utilisateur a le rôle Super Administration. 100 - L’utilisateur a le rôle Visionneuse . 203 - L’utilisateur a le rôle Utilisateur standard . Pour plus d’informations, consultez le guide technique rôles d’utilisateur . Envoyer: Obligatoire Inscription: Obligatoire. L’ID de rôle doit être défini sur 41 ou 203. |
int |
Configuration requise
Service : CustomerManagementService.svc v13
Noms: https://bingads.microsoft.com/Customer/v13/Entities