Oggetto dati UserInvitation - Customer Management

Definisce un invito per un utente a iscriversi a Microsoft Advertising. L'invito limita l'accesso all'account e le autorizzazioni.

È possibile inviare più inviti in sospeso allo stesso indirizzo di posta elettronica, che non sono ancora scaduti. È anche possibile che tali inviti abbiano ruoli utente diversi, ad esempio se è stato inviato un invito con un ruolo utente errato e quindi è stato inviato un secondo invito con il ruolo utente corretto. Il destinatario può accettare qualsiasi invito e iscriversi con credenziali diverse dall'indirizzo di posta elettronica dell'invito. Gli utenti di Microsoft Advertising possono accettare inviti a più clienti con le stesse credenziali. Per altre informazioni, vedere la guida tecnica Multi-User Credentials .

È possibile cercare gli inviti in sospeso in base all'ID invito e verificare se l'invito è stato accettato o è scaduto. L'operazione SearchUserInvitations restituisce tutti gli inviti in sospeso, indipendentemente dal fatto che siano scaduti o meno. Gli inviti accettati non sono inclusi nella risposta SearchUserInvitations .

Dopo aver accettato l'invito, è possibile chiamare GetUsersInfo e GetUser per accedere ai dettagli utente di Microsoft Advertising. Tuttavia, poiché un destinatario può accettare l'invito e iscriversi con credenziali diverse dall'indirizzo di posta elettronica dell'invito, non è possibile determinare con certezza il mapping da un oggetto UserInvitation a un oggetto User o UserInfo . Con l'ID utente restituito da GetUsersInfo o GetUser, è possibile chiamare DeleteUser per rimuovere l'utente in base alle esigenze. L'API Bing Ads non supporta alcuna operazione per eliminare gli inviti utente in sospeso. Dopo aver invitato un utente, l'unico modo per annullare l'invito è tramite l'applicazione Web Microsoft Advertising. È possibile trovare inviti in sospeso e accettati nella sezione Utenti di Account & Fatturazione.

Sintassi

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

{
  "AccountIds": [
    "LongValueHere"
  ],
  "CustomerId": "LongValueHere",
  "Email": "ValueHere",
  "ExpirationDate": "ValueHere",
  "FirstName": "ValueHere",
  "Id": "LongValueHere",
  "LastName": "ValueHere",
  "Lcid": "ValueHere",
  "RoleId": IntValueHere
}

Elementi

L'oggetto UserInvitation include gli elementi seguenti: AccountIds, CustomerId, Email, ExpirationDate, FirstName, Id, LastName, Lcid, RoleId.

Requisiti

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

Usato da

SearchUserInvitations
SendUserInvitation
SignupCustomer