Opération du service SendUserInvitation - Gestion des clients

Envoie une invitation par e-mail pour qu’un utilisateur s’inscrive à Microsoft Advertising. L’invitation limite l’accès au compte et les autorisations.

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.

Éléments de demande

L’objet SendUserInvitationRequest définit les éléments body et header de la demande d’opération de service. Les éléments doivent être dans le même ordre que celui indiqué dans la requête SOAP.

Éléments du corps de la requête

Éléments d’en-tête de requête

Éléments Response

L’objet SendUserInvitationResponse définit les éléments body et header de la réponse de l’opération de service. Les éléments sont retournés dans le même ordre que celui indiqué dans la réponse SOAP.

Response Body, éléments

Éléments d’en-tête de réponse

Requête SOAP

Ce modèle a été généré par un outil pour afficher l’ordre des éléments body et header pour la requête SOAP. Pour connaître les types pris en charge que vous pouvez utiliser avec cette opération de service, consultez la référence Éléments du corps de la demande ci-dessus.

<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">SendUserInvitation</Action>
    <AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
    <DeveloperToken i:nil="false">ValueHere</DeveloperToken>
  </s:Header>
  <s:Body>
    <SendUserInvitationRequest xmlns="https://bingads.microsoft.com/Customer/v13">
      <UserInvitation xmlns:e263="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
        <e263:Id>ValueHere</e263:Id>
        <e263:FirstName i:nil="false">ValueHere</e263:FirstName>
        <e263:LastName i:nil="false">ValueHere</e263:LastName>
        <e263:Email i:nil="false">ValueHere</e263:Email>
        <e263:CustomerId>ValueHere</e263:CustomerId>
        <e263:RoleId>ValueHere</e263:RoleId>
        <e263:AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <a1:long>ValueHere</a1:long>
        </e263:AccountIds>
        <e263:ExpirationDate>ValueHere</e263:ExpirationDate>
        <e263:Lcid>ValueHere</e263:Lcid>
      </UserInvitation>
    </SendUserInvitationRequest>
  </s:Body>
</s:Envelope>

Soap de réponse

Ce modèle a été généré par un outil pour afficher l’ordre des éléments de corps et d’en-tête pour la réponse 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>
    <SendUserInvitationResponse xmlns="https://bingads.microsoft.com/Customer/v13">
      <UserInvitationId>ValueHere</UserInvitationId>
    </SendUserInvitationResponse>
  </s:Body>
</s:Envelope>

Syntaxe du code

L’exemple de syntaxe peut être utilisé avec les Kits de développement logiciel (SDK) Bing Ads. Pour plus d’exemples, consultez Exemples de code de l’API Bing Ads .

public async Task<SendUserInvitationResponse> SendUserInvitationAsync(
	UserInvitation userInvitation)
{
	var request = new SendUserInvitationRequest
	{
		UserInvitation = userInvitation
	};

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

static SendUserInvitationResponse sendUserInvitation(
	UserInvitation userInvitation) throws RemoteException, Exception
{
	SendUserInvitationRequest request = new SendUserInvitationRequest();

	request.setUserInvitation(userInvitation);

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

static function SendUserInvitation(
	$userInvitation)
{

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

	$request = new SendUserInvitationRequest();

	$request->UserInvitation = $userInvitation;

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

response=customermanagement_service.SendUserInvitation(
	UserInvitation=UserInvitation)

Configuration requise

Service : CustomerManagementService.svc v13
Noms: https://bingads.microsoft.com/Customer/v13