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.
Importante
Quando l'invito viene inviato, puoi scegliere di limitare l'accesso dell'utente a un subset di account dell'inserzionista che si trovano direttamente sotto il cliente. Se una gerarchia di agenzie viene configurata (ora o in futuro) nel cliente in cui l'utente è invitato e se non si limita l'accesso a account specifici, l'utente avrà accesso a tutti gli account nella gerarchia.
È 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>
Elementi
L'oggetto UserInvitation include gli elementi seguenti: AccountIds, CustomerId, Email, ExpirationDate, FirstName, Id, LastName, Lcid, RoleId.
| Elemento | Descrizione | Tipo di dati |
|---|---|---|
| AccountIds | Matrice di identificatori degli account che l'utente può gestire. Per specificare che l'utente può gestire tutti gli account correnti e futuri del cliente a cui appartiene l'utente, impostare su NULL. Gli utenti con ruoli a livello di account, ad esempio Advertiser Campaign Manager, possono essere limitati a account specifici. Gli utenti con ruoli a livello di cliente come Super Amministrazione possono accedere a tutti gli account all'interno del cliente dell'utente e il loro accesso non può essere limitato a account specifici. Quando si tenta di limitare i ruoli utente a livello di cliente, ad esempio quando si tenta di limitare un Amministrazione super a account specifici, l'operazione non avrà esito negativo e all'utente verrà concesso l'accesso per tutti gli account all'interno del cliente specificato. Invia: Opzionale Iscrizione: Opzionale |
matrice long |
| Customerid | Identificatore del cliente che l'utente è invitato a gestire. L'elemento AccountIds determina gli account del cliente che l'utente può gestire. Invia: Obbligatorio Iscrizione: Sola lettura |
long |
| Posta elettronica | Indirizzo di posta elettronica corrispondente all'account Microsoft dell'utente. L'indirizzo può contenere un massimo di 100 caratteri. Invia: Obbligatorio Iscrizione: Obbligatorio |
Stringa |
| ExpirationDate | Data e ora di scadenza dell'invito utente. Il valore è espresso nell'ora UTC (Coordinated Universal Time). La durata di un invito utente è soggetta a modifiche e attualmente impostata su 30 giorni. Non è possibile impostare o aggiornare questo valore. Invia: Sola lettura Iscrizione: Sola lettura |
Datetime |
| FirstName | Nome dell'utente. Il nome è limitato a 40 caratteri. Invia: Obbligatorio Iscrizione: Obbligatorio |
Stringa |
| Id | Identificatore univoco generato dal sistema per l'invito utente. Invia: Sola lettura Iscrizione: Sola lettura |
long |
| LastName | Cognome dell'utente. Il cognome è limitato a 40 caratteri. Invia: Obbligatorio Iscrizione: Obbligatorio |
Stringa |
| Lcid | Impostazioni locali da utilizzare per l'invio di corrispondenza all'utente tramite posta elettronica o posta postale. Il valore predefinito è EnglishUS. Invia: Obbligatorio Iscrizione: Obbligatorio |
LCID |
| Roleid | Ruolo dell'utente per ogni cliente o elenco di account. I valori possibili includono: 16 - L'utente ha il ruolo Advertiser Campaign Manager . 33 - L'utente ha il ruolo Aggregatore . 41 - L'utente ha il ruolo Super Amministrazione. 100 - L'utente ha il ruolo Visualizzatore . 203 - L'utente ha il ruolo Utente Standard . Per altre informazioni, vedere la Guida tecnica per i ruoli utente . Invia: Obbligatorio Iscrizione: Obbligatorio. L'ID ruolo deve essere impostato su 41 o 203. |
int |
Requisiti
Servizio: CustomerManagementService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13/Entities