Freigeben über

UserInvitation-Datenobjekt – Kundenverwaltung

  • Artikel

Definiert eine Einladung für einen Benutzer, sich für Microsoft Advertising zu registrieren. Die Einladung schränkt den Kontozugriff und die Berechtigungen ein.

Wichtig

Wenn die Einladung gesendet wird, können Sie den Benutzerzugriff auf eine Teilmenge von Werbekundenkonten beschränken, die sich direkt unter Ihrem Kunden befinden. Wenn eine Agenturhierarchie (jetzt oder in Zukunft) unter dem Kunden eingerichtet wird, in dem der Benutzer eingeladen wird, und wenn Sie den Zugriff nicht auf bestimmte Konten beschränken, hat der Benutzer Zugriff auf alle Konten in der Hierarchie.

Es ist möglich, dass mehrere ausstehende Einladungen an dieselbe E-Mail-Adresse gesendet werden, die noch nicht abgelaufen sind. Es ist auch möglich, dass diese Einladungen unterschiedliche Benutzerrollen angegeben haben, z. B. wenn Sie eine Einladung mit einer falschen Benutzerrolle und dann eine zweite Einladung mit der richtigen Benutzerrolle gesendet haben. Der Empfänger kann alle Einladungen annehmen und sich mit Anmeldeinformationen registrieren, die von der E-Mail-Adresse der Einladung abweichen. Microsoft Advertising-Benutzer können Einladungen an mehrere Kunden mit denselben Anmeldeinformationen annehmen. Weitere Informationen finden Sie im technischen Leitfaden für Mehrbenutzeranmeldeinformationen .

Sie können nach ausstehenden Einladungen anhand der Einladungs-ID suchen und herausfinden, ob die Einladung angenommen wurde oder nicht. Der SearchUserInvitations-Vorgang gibt alle ausstehenden Einladungen zurück, unabhängig davon, ob sie abgelaufen sind. Akzeptierte Einladungen sind nicht in der SearchUserInvitations-Antwort enthalten.

Nachdem die Einladung angenommen wurde, können Sie GetUsersInfo und GetUser aufrufen, um auf die Microsoft Advertising-Benutzerdetails zuzugreifen. Da ein Empfänger jedoch die Einladung annehmen und sich mit Anmeldeinformationen registrieren kann, die von der E-Mail-Adresse der Einladung abweichen, können Sie die Zuordnung einer UserInvitation zu einem User - oder UserInfo-Objekt nicht mit Sicherheit bestimmen. Wenn die Benutzer-ID von GetUsersInfo oder GetUser zurückgegeben wird, können Sie DeleteUser aufrufen, um den Benutzer nach Bedarf zu entfernen. Die Bing Ads-API unterstützt keine Vorgänge zum Löschen ausstehender Benutzereinladungen. Nachdem Sie einen Benutzer eingeladen haben, kann die Einladung nur über die Microsoft Advertising-Webanwendung abgebrochen werden. Sie finden sowohl ausstehende als auch akzeptierte Einladungen im Abschnitt Benutzer unter Konten & Abrechnung.

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

Elemente

Das UserInvitation-Objekt weist die folgenden Elemente auf: AccountIds, CustomerId, Email, ExpirationDate, FirstName, ID, LastName, Lcid, RoleId.

Element Beschreibung Datentyp
AccountIds Ein Array von Bezeichnern der Konten, die der Benutzer verwalten kann. Legen Sie auf NULL fest, um anzugeben, dass der Benutzer alle aktuellen und zukünftigen Konten des Kunden verwalten kann, zu dem der Benutzer gehört.

Benutzer mit Rollen auf Kontoebene, z. B. Advertiser Campaign Manager, können auf bestimmte Konten beschränkt werden. Benutzer mit Rollen auf Kundenebene wie Super Admin können auf alle Konten innerhalb des Kunden des Benutzers zugreifen, und ihr Zugriff kann nicht auf bestimmte Konten beschränkt werden.

Beim Versuch, Benutzerrollen auf Kundenebene einzuschränken, z. B. beim Versuch, eine Super-Admin auf bestimmte Konten zu beschränken, schlägt der Vorgang nicht fehl, und dem Benutzer wird Zugriff für alle Konten innerhalb des angegebenen Kunden gewährt.

Senden: Wahlfrei
Registrierung: Wahlfrei		 langes Array
CustomerId Der Bezeichner des Kunden, zu dem dieser Benutzer eingeladen wird. Das AccountIds-Element bestimmt, welche Kundenkonten der Benutzer verwalten kann.

Senden: Erforderlich
Registrierung: Schreibgeschützt		 lang
E-Mail Die E-Mail-Adresse, die dem Microsoft-Konto des Benutzers entspricht. Die Adresse darf maximal 100 Zeichen enthalten.

Senden: Erforderlich
Registrierung: Erforderlich		 Zeichenfolge
ExpirationDate Das Datum und die Uhrzeit, zu dem die Benutzerinladung abläuft. Der Wert wird in UTC (Coordinated Universal Time) angegeben.

Die Dauer einer Benutzerinladung kann sich ändern und ist derzeit auf 30 Tage festgelegt. Sie können diesen Wert nicht festlegen oder aktualisieren.

Senden: Schreibgeschützt
Registrierung: Schreibgeschützt		 dateTime
FirstName Der Vorname des Benutzers.

Der Vorname ist auf 40 Zeichen beschränkt.

Senden: Erforderlich
Registrierung: Erforderlich		 Zeichenfolge
Id Ein vom System generierter eindeutiger Bezeichner für die Benutzerinladung.

Senden: Schreibgeschützt
Registrierung: Schreibgeschützt		 lang
LastName Der Nachname des Benutzers.

Der Nachname ist auf 40 Zeichen beschränkt.

Senden: Erforderlich
Registrierung: Erforderlich		 Zeichenfolge
Lcid Das Gebietsschema, das beim Senden von Korrespondenz an den Benutzer per E-Mail oder Post verwendet werden soll.

Der Standardwert ist EnglishUS.

Senden: Erforderlich
Registrierung: Erforderlich		 LCID
RoleId Die Rolle, die der Benutzer für jeden Kunden oder jede Liste von Konten hat.

Mögliche Werte:
16 – Der Benutzer verfügt über die Rolle "Advertiser Campaign Manager ".
33 – Der Benutzer verfügt über die Aggregatorrolle .
41 – Der Benutzer hat die Rolle Super Admin.
100 : Der Benutzer verfügt über die Rolle "Viewer ".
203 – Der Benutzer verfügt über die Rolle Standard Benutzer.

Weitere Informationen finden Sie im technischen Leitfaden zu Benutzerrollen .
Senden: Erforderlich
Registrierung: Erforderlich. Die Rollen-ID muss auf 41 oder 203 festgelegt werden.		 int

Anforderungen

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

Verwendet von

SearchUserInvitations
SendUserInvitation
SignupCustomer