Informazioni di riferimento sulle API hotel

Nota

Questa versione beta di Hotel Price Ads è disponibile solo per selezionare i partecipanti. Per informazioni sulla partecipazione al programma di versione beta, contattare il proprio account manager o registrarsi qui.

L'API e la documentazione sono soggette a modifiche.

L'API Hotel consente di gestire le campagne pubblicitarie e le offerte degli hotel.

Endpoint

Di seguito è riportato l'URI di base usato per costruire l'endpoint.

• Produzione—https://partner.api.bingads.microsoft.com/Travel/v1/

L'endpoint deve includere le risorse del cliente e dell'account.

https://partner.api.sandbox.bingads.microsoft.com/Travel/V1/Customers({customerId})/Accounts({accountId})/

Impostare {customerId} sul CustomerId del cliente e {accountId} sul CustomerAccountId del cliente.

Aggiungere quindi un modello dalla tabella seguente per aggiungere, ottenere e aggiornare le risorse dell'hotel. Ad esempio, per ottenere o aggiungere un gruppo di hotel, usare l'endpoint seguente:

https://partner.api.sandbox.bingads.microsoft.com/Travel/V1/Customers({customerId})/Accounts({accountId})/SubAccounts('{subAccountId}')/HotelGroups

Nota

Gli ID per SubAccounts, HotelGroups, Hotels e ReportJobs sono stringhe e devono essere racchiusi tra virgolette singole. Ad esempio, SubAccounts('12345')/HotelGroups. Questo vale solo per SubAccounts, HotelGroups, Hotels e ReportJobs; non usare virgolette singole per clienti e account.

Modello SubAccounts

Verbo	Descrizione
GET	Ottiene l'elenco di campagne di alloggio (in precedenza campagne di hotel) definite per l'account specificato. NOTA: per impostazione predefinita, l'elenco contiene un massimo di 1.000 campagne. Per determinare il numero totale di campagne nell'account secondario, usare il parametro di query $count . Per specificare il numero di campagne da restituire, usare il parametro di query $top . Per scorrere tutte le campagne in un account secondario, usare i parametri di query $top e $skip . Corpo della risposta: contiene un oggetto CollectionResponse . Il value campo contiene l'elenco di oggetti SubAccount .
POST	Aggiunge l'account secondario all'account specificato. È possibile considerare gli account secondari come campagne di alloggio. Usa gli account secondari per organizzare logicamente le tue campagne pubblicitarie per hotel. Potresti avere un massimo di 50 campagne di alloggio attive per account. Corpo della richiesta: contiene l'oggetto SubAccount da aggiungere. Corpo della risposta: se ha esito positivo, contiene un oggetto AddResponse . Il value campo contiene l'ID della campagna di alloggio aggiunta.

Modello SubAccounts('{subAccountId}')

Verbo	Descrizione
GET	Ottiene il sottoaccount specificato. Corpo della risposta: contiene un oggetto SubAccount . Parametri del modello: {subAccountId}- Impostare sull'ID dell'account secondario da ottenere.
BENDA	Aggiornamenti il sottoaccount. Corpo della richiesta: contiene un oggetto SubAccount che specifica solo i campi da aggiornare. Corpo della risposta: nessuno. In caso di esito positivo, restituisce il codice di stato HTTP 204. Parametri del modello: {subAccountId}- Impostare sull'ID dell'account secondario da aggiornare.

Modello SubAccounts('{subAccountId}')/HotelGroups

Verbo	Descrizione
GET	Ottiene l'elenco dei gruppi di hotel nell'account secondario specificato. NOTA: per impostazione predefinita, l'elenco contiene un massimo di 1.000 gruppi di hotel. Per determinare il numero totale di gruppi nell'account secondario, usare il parametro di query $count . Per specificare il numero di gruppi da restituire, usare il parametro di query $top . Per scorrere tutti i gruppi in un account secondario, usare i parametri di query $top e $skip . Corpo della risposta: contiene un oggetto CollectionResponse . Il value campo contiene l'elenco di oggetti HotelGroup . Parametri del modello: {subAccountId}- Impostare sull'ID dell'account secondario che contiene i gruppi di hotel da ottenere.
POST	Aggiunge il gruppo di hotel all'account secondario specificato. Usare i gruppi di hotel per creare raggruppamenti logici di annunci sui prezzi degli hotel. È possibile creare fino a 1.000 gruppi di hotel attivi per ogni account secondario. Corpo della richiesta: contiene l'elemento HotelGroup da aggiungere all'account secondario. Corpo della risposta: se ha esito positivo, contiene un oggetto AddResponse . Il value campo contiene l'ID del gruppo di hotel aggiunto. Parametri del modello: {subAccountId}- Impostare sull'ID dell'account secondario a cui aggiungere il gruppo di hotel.

Modello SubAccounts('{subAccountId}')/HotelGroups('{hotelGroupId}')

Verbo	Descrizione
GET	Ottiene il gruppo di hotel specificato. Corpo della risposta: contiene un oggetto HotelGroup . Parametri del modello: {subAccountId}- Impostare sull'ID del sottoaccount che contiene il gruppo di hotel. {hotelGroupId}- Impostare sull'ID del gruppo di hotel da ottenere.
BENDA	Aggiornamenti il gruppo alberghiero. Corpo della richiesta: contiene un oggetto HotelGroup che specifica solo i campi da aggiornare. Corpo della risposta: nessuno. In caso di esito positivo, restituisce il codice di stato HTTP 204. Parametri del modello: {subAccountId}- Impostare sull'ID del sottoaccount che contiene il gruppo di hotel. {hotelGroupId}- Impostare sull'ID del gruppo di hotel da aggiornare.
ELIMINA	Elimina il gruppo di hotel. Corpo della richiesta: nessuno. Corpo della risposta: nessuno. In caso di esito positivo, restituisce il codice di stato HTTP 204. Parametri del modello: {subAccountId}- Impostare sull'ID del sottoaccount che contiene il gruppo di hotel. {hotelGroupId}- Impostare sull'ID del gruppo di hotel da eliminare.

Modello SubAccounts('{subAccountId}')/Hotels

Verbo

Descrizione

GET

Ottiene l'elenco degli annunci di prezzo dell'hotel nell'account secondario specificato. L'elenco contiene tutti gli hotel in tutti i gruppi di hotel nell'account secondario. NOTA: per impostazione predefinita, l'elenco contiene un massimo di 1.000 hotel. Per determinare il numero totale di hotel nell'account secondario, usare il parametro di query $count . Per specificare il numero di hotel da restituire, usare il parametro di query $top . Per scorrere tutti gli hotel in un account secondario, usare i parametri di query $top e $skip . NOTA: usa questa chiamata per scorrere gli hotel solo in un'esperienza dell'interfaccia utente. Non utilizzare questa chiamata per scaricare tutti gli hotel. Per scaricare tutti gli hotel, usare invece la funzionalità Report . Corpo della risposta: contiene un oggetto CollectionResponse . Il value campo contiene l'elenco di oggetti Hotel . Parametri del modello: {subAccountId}- Impostare sull'ID dell'account secondario che contiene gli hotel da ottenere. .

Modello SubAccounts('{subAccountId}')/HotelGroups('{hotelGroupId}')/Hotels

Verbo

Descrizione

GET

Ottiene l'elenco degli annunci di prezzo dell'hotel nel gruppo di hotel specificato. NOTA: per impostazione predefinita, l'elenco contiene un massimo di 1.000 hotel. Per determinare il numero totale di hotel nel gruppo di hotel, usare il parametro di query $count . Per specificare il numero di hotel da restituire, usare il parametro di query $top . Per scorrere tutti gli hotel di un gruppo, usare i parametri di query $top e $skip . NOTA: usa questa chiamata per scorrere gli hotel solo in un'esperienza dell'interfaccia utente. Non utilizzare questa chiamata per scaricare tutti gli hotel. Per scaricare tutti gli hotel, usare invece la funzionalità Report . Corpo della risposta: contiene un oggetto CollectionResponse . Il value campo contiene l'elenco di oggetti Hotel . Parametri del modello: {subAccountId}- Impostare sull'ID del sottoaccount che contiene il gruppo di hotel. {hotelGroupId}- Impostare sull'ID del gruppo di hotel che contiene gli hotel da ottenere. .

Modello SubAccounts('{subAccountId}')/HotelGroups('{hotelGroupId}')/Hotels('{hotelId}')

Verbo	Descrizione
GET	Ottiene l'annuncio dell'hotel specificato. Corpo della risposta: contiene un oggetto Hotel . Parametri del modello: {subAccountId}- Impostare sull'ID del sottoaccount che contiene il gruppo di hotel. {hotelGroupId}- Impostare sull'ID del gruppo di hotel che contiene l'hotel da ottenere. {hotelId}- Impostare sull'annuncio dell'hotel da ottenere.
BENDA	Aggiornamenti l'annuncio dell'hotel. Corpo della richiesta: contiene un oggetto Hotel che specifica solo i campi da aggiornare. Corpo della risposta: nessuno. In caso di esito positivo, restituisce il codice di stato HTTP 204. Parametri del modello: {subAccountId}- Impostare sull'ID del sottoaccount che contiene il gruppo di hotel. {hotelGroupId}- Impostare sull'ID del gruppo di hotel che contiene l'hotel da aggiornare. {hotelId}- Impostare sull'ID dell'hotel da aggiornare. È possibile impostare questo parametro sull'ID assegnato da Microsoft all'hotel o sull'ID assegnato dall'inserzionista all'hotel. Se la si imposta sull'ID dell'inserzionista, è necessario impostare il parametro di PartnerHotelId query su true. Parametri di query: PartnerHotelId- Impostare su true se il parametro della {hotelId} risorsa contiene l'ID assegnato dall'inserzionista all'hotel. Se questo parametro è impostato su false o è mancante, l'ID è quello assegnato da Microsoft. Il valore predefinito è false.

SubAccounts('{subAccountId}')/Ungrouped template

Verbo

Descrizione

GET

Ottiene l'elenco di hotel nel gruppo di hotel ungrouped. Quando si crea un account secondario, il servizio crea il gruppo di hotel non raggruppati. Tutti gli hotel del feed dell'hotel che non sono altrimenti associati ad altri gruppi vengono inseriti in questo gruppo. Per associare un hotel in questo gruppo a un gruppo di hotel diverso, vedere il modello Associa . NOTA: per impostazione predefinita, l'elenco contiene un massimo di 1.000 hotel. Per determinare il numero totale di hotel nel gruppo di hotel non raggruppati, usare il parametro di query $count . Per specificare il numero di hotel da restituire, usare il parametro di query $top . Per scorrere tutti gli hotel del gruppo, usare i parametri di query $top e $skip . NOTA: usa questa chiamata per scorrere gli hotel solo in un'esperienza dell'interfaccia utente. Non utilizzare questa chiamata per scaricare tutti gli hotel. Per scaricare tutti gli hotel, usare invece la funzionalità Report . Corpo della risposta: contiene un oggetto CollectionResponse . Il value campo contiene l'elenco di oggetti Hotel . Parametri del modello: {subAccountId}- Impostare sull'ID dell'account secondario che contiene gli annunci di prezzo dell'hotel non raggruppati da ottenere.

Modello SubAccounts('{subAccountId}')/Associations

Verbo

Descrizione

GET

Ottiene un elenco di associazioni di hotel e gruppi di hotel. NOTA: per impostazione predefinita, l'elenco contiene un massimo di 1.000 associazioni. Per determinare il numero totale di associazioni nell'account secondario, usare il parametro di query $count . Per specificare il numero di associazioni da restituire, usare il parametro di query $top . Per scorrere tutte le associazioni in un account secondario, usare i parametri di query $top e $skip . Corpo della risposta: contiene un oggetto CollectionResponse . Il value campo contiene l'elenco di oggetti HotelAssociation . Parametri del modello: {subAccountId}- Impostare sull'ID del sottoaccount che contiene le associazioni da ottenere.

SubAccounts('{subAccountId}')/Associa modello

Verbo

Descrizione

POST

Aggiunge un elenco di associazioni di hotel e gruppi di hotel all'account secondario. Corpo della richiesta: contiene un oggetto AssociationCollection . Il HotelAssociation campo contiene un elenco con un massimo di 500 oggetti HotelAssociation . Ogni oggetto associa un hotel a un gruppo di hotel. È possibile associare un hotel solo a un gruppo di hotel. Per impostazione predefinita, gli hotel sono associati al gruppo di hotel non raggruppati . Per associare un hotel a un nuovo gruppo di hotel, usare questo modello. Quando si associa un hotel a un nuovo gruppo di hotel, il servizio rimuove l'associazione precedente. Corpo della risposta: contiene un oggetto CollectionResponse . Il value campo contiene un elenco di oggetti HotelAssociation . L'elenco contiene solo le associazioni che non hanno superato la convalida. L'elenco è vuoto se non sono presenti errori. Il campo dell'associazione Errors contiene l'elenco dei motivi per cui l'associazione non è riuscita. Parametri del modello: {subAccountId}- Impostare sull'ID dell'account secondario a cui aggiungere le associazioni.

Modello ReportJobs

Verbo

Descrizione

POST

Aggiunge una richiesta di report alla coda del report. Corpo della richiesta: contiene l'oggetto ReportJob che definisce la richiesta di report che si sta aggiungendo alla coda. Corpo della risposta: se la richiesta di report viene aggiunta correttamente alla coda, il corpo è un oggetto AddResponse che contiene l'ID del processo del report. Usare l'ID nelle richieste GET successive per ottenere lo stato del processo del report (vedere il modello ReportJobs('{jobId}').

ReportJobs('{jobId}')

Verbo

Descrizione

GET

Ottiene lo stato del processo di report specificato. Corpo della risposta: contiene un oggetto ReportJob . Utilizzare il Status campo per determinare al termine del processo. Al termine del processo, usare l'URL nel Url campo per scaricare il report. Parametri del modello: {jobId}- ID del processo del report di cui ottenere lo stato. Impostare sull'ID del processo di report restituito dalla richiesta POST.

modello $batch

Verbo	Descrizione
POST	Invia una richiesta batch che può contenere un massimo di 500 richieste. Altre informazioni Corpo della richiesta: contiene una stringa delle singole richieste. Corpo della risposta: contiene una stringa delle risposte corrispondenti.

Parametri di query

Di seguito sono riportati i parametri di query che la richiesta può specificare.

Parametro	Descrizione
$count	Parametro OData che determina se la risposta include un @odata.count campo. In genere, questo parametro viene incluso quando si richiede un elenco di entità, ad esempio un elenco di gruppi di hotel. Il @odata.count campo contiene il numero totale di entità risorsa disponibili, non quelle restituite nella richiesta. Ad esempio, se si imposta $top su 40, ma esistono 1.000 entità, @odata.count è impostato su 1.000, non su 40. Per includere il conteggio, impostare $count su true.
$filter	Parametro OData che specifica un elenco di espressioni usate per filtrare i dati. NOTA: È possibile usare il parametro $filter solo con la risorsa /Associations . Per altre informazioni, vedere Filtro delle associazioni di hotel.
$select	Parametro OData che specifica un elenco delimitato da virgole dei campi da includere nella risposta. Ai nomi dei campi viene applicata la distinzione tra maiuscole e minuscole. Ad esempio, per includere il nome, l'ID partner e i campi di offerta dell'hotel nella risposta, specificare il parametro seguente: $select=Name,PartnerHotelId,Bid
$skip	Parametro OData che specifica il numero di entità risorsa da ignorare prima di restituire le entità. Il valore $skip deve essere un multiplo di $top. Se si specifica un valore non compreso nell'intervallo, la risposta contiene un set vuoto. Usare $top e $skip per scorrere un elenco di entità di risorse.
$top	Parametro OData che specifica il numero di entità risorsa da restituire. Il valore predefinito è 1.000 e il valore massimo che è possibile specificare è 5.000. Usare $top e $skip per scorrere un elenco di entità di risorse.

Intestazioni

Di seguito sono riportate le intestazioni di richiesta e risposta.

Intestazione	Descrizione
Autorizzazione	Intestazione della richiesta. Impostare questa intestazione su un token di accesso OAuth bearer. Ad esempio, "Authorization: Bearer QTkxRUFBRjEzOTUyNEIx...". Per informazioni su come ottenere un token, vedere Introduzione.
Tipo di contenuto	Intestazione della richiesta e della risposta. Tipo di contenuto nel corpo della richiesta o della risposta. Per POST e PATCH, impostare questa intestazione su application/json.
X-MS-RequestId	Intestazione della risposta. ID della voce di log che contiene i dettagli della richiesta. È consigliabile acquisire sempre questo ID se si verifica un errore. Se non si è in grado di determinare e risolvere il problema, includere questo ID insieme alle altre informazioni fornite al team di supporto.

Nota

Questa API supporta l'uso dei token di accesso OAuth solo per l'autenticazione (vedere l'intestazione Authorization). Non è possibile usare le intestazioni UserName e Password per specificare le credenziali legacy.

Questa API non richiede un token per sviluppatori. Se si include l'intestazione DeveloperToken, l'API la ignora.

Oggetti risorsa

Di seguito sono riportati gli oggetti risorsa usati dall'API.

Oggetto	Descrizione
AddResponse	Definisce un oggetto risposta per le richieste che aggiungono una risorsa.
AdsApiError	Definisce un errore che si è verificato.
AdvanceBookingWindowMultiplier	Definisce l'importo per modificare l'offerta di base se l'utente prenota il numero specificato di giorni in anticipo.
AssociationCollection	Definisce una raccolta di associazioni di hotel.
Bilancio	Definisce il budget giornaliero per gli annunci sui prezzi degli hotel in un account secondario.
CollectionResponse	Definisce un oggetto risposta per le richieste che ottengono un elenco di risorse.
CheckinDayOfWeekMultiplier	Definisce l'importo per modificare l'offerta di base se l'utente effettua l'accesso in uno dei giorni feriali specificati.
DateTypeMultiplier	Definisce l'importo per modificare l'offerta di base se l'utente ha cercato hotel usando date specifiche.
DeviceMultiplier	Definisce l'importo per modificare l'offerta di base se l'utente usa uno dei dispositivi specificati per cercare gli hotel.
FixedBid	Definisce un importo fisso per l'offerta.
Hotel	Definisce un annuncio dell'hotel.
HotelAssociation	Definisce l'associazione tra un hotel e un gruppo di hotel.
HotelGroup	Definisce un raggruppamento logico di annunci prezzo hotel.
LengthOfStayMultiplier	Definisce l'importo per modificare l'offerta di base se l'utente rimane il numero specificato di notti o più.
PercentageBid	Definisce un'offerta in base alla percentuale della tariffa totale della camera per notte.
Processo report	Definisce un processo di report.
SiteMultiplier	Definisce l'importo per modificare l'offerta di base se l'utente sta cercando hotel in uno dei siti Bing specificati.
Subaccount	Definisce il raggruppamento di annunci di prezzo dell'hotel di primo livello. Si può pensare a questo logicamente come una campagna di alloggio.
UserCountryMultiplier	Definisce l'importo per modificare l'offerta di base se l'utente accede a uno dei domini Bing.

Nota

Gli oggetti risposta includono un campo di contesto. Poiché questo campo potrebbe essere eliminato in futuro o il modello potrebbe cambiare, non è consigliabile assumerne una dipendenza. L'assunzione di una dipendenza da questo campo potrebbe interrompere il codice in futuro.

AddResponse

Definisce un oggetto risposta per le richieste che aggiungono una risorsa.

Name	Valore	Tipo
valore	ID della risorsa aggiunta.	Oggetto

AdsApiError

Definisce un errore che si è verificato.

Name	Valore	Tipo
Codice	Codice simbolico che identifica l'errore. Per un elenco dei codici, vedere Codici di errore.	Stringa
Messaggio	Descrizione dell'errore.	Stringa
Parametro	Nome dell'oggetto, del campo o del parametro che ha causato l'errore.	Stringa

AdvanceBookingWindowMultiplier

Definisce l'importo per modificare l'offerta di base se l'utente prenota il numero specificato di giorni in anticipo.

Name	Valore	Tipo	Aggiunta	Update
Fattore	Importo percentuale di cui modificare l'offerta di base. L'intervallo valido è compreso tra 0,00 e 11,00. Ad esempio, se l'offerta fissa è $5 e il moltiplicatore è 5, l'offerta finale è $25. Usando lo stesso moltiplicatore, se l'offerta percentuale è del 5% e la tariffa totale della stanza è $100, l'offerta finale è $25.	Double	Obbligatorio	Facoltativo
MinimumNumberOfDays	Numero minimo di giorni prima della prenotazione. Applicare il moltiplicatore se la prenotazione avviene in anticipo sul numero specificato di giorni o più.	Numero intero	Obbligatorio	Facoltativo
@odata.type	Tipo dell'oggetto. Questo campo è impostato su "#Model.AdvanceBookingWindowMultiplier".	Stringa	Obbligatorio	Obbligatorio

AssociationCollection

Definisce una raccolta di associazioni di hotel.

Name	Valore	Tipo	Aggiunta	Update
HotelAssociations	Elenco delle associazioni di hotel e gruppi alberghieri. L'elenco può contenere un massimo di 500 associazioni.	HotelAssociation[]	Obbligatorio	N/D

Offerta

Definisce la classe di base per un'offerta.

Non specificare questa classe, ma specificare la classe FixedBid o PercentageBid .

Name	Valore	Tipo	Aggiunta	Update
Quantità	Importo dell'offerta in dollari. Per informazioni dettagliate sull'intervallo di offerte valido per il mercato, vedere la tabella Valore valuta nell'argomento Valute . L'account del cliente specifica la valuta utilizzata.	Double	Obbligatorio	Facoltativo

Bilancio

Definisce il budget giornaliero per gli annunci sui prezzi degli hotel in un account secondario.

Name	Valore	Tipo	Aggiunta	Update
Quantità	Importo del budget giornaliero. Per informazioni dettagliate sui budget validi per il mercato, vedere la tabella Valore valuta nell'argomento Valute . Il conto del cliente specifica la valuta utilizzata per il budget.	Double	Obbligatorio	Facoltativo

CheckinDayOfWeekMultiplier

Definisce l'importo per modificare l'offerta di base se l'utente effettua l'accesso in uno dei giorni feriali specificati.

Name	Valore	Tipo	Aggiunta	Update
DaysOfWeek	Elenco dei giorni feriali. Applicare il moltiplicatore se l'utente controlla uno dei giorni specificati. Di seguito sono riportati i possibili valori con distinzione tra maiuscole e minuscole. Lunedì Martedì Mercoledì Giovedì Venerdì Sabato Domenica	String[]	Obbligatorio	Facoltativo
Fattore	Importo percentuale di cui modificare l'offerta di base. L'intervallo valido è compreso tra 0,00 e 10,00. Ad esempio, se l'offerta fissa è $5 e il moltiplicatore è 5, l'offerta finale è $25. Usando lo stesso moltiplicatore, se l'offerta percentuale è del 5% e la tariffa totale della stanza è $100, l'offerta finale è $25.	Double	Obbligatorio	Facoltativo
@odata.type	Tipo dell'oggetto. Questo campo è impostato su "#Model.CheckinDayOfWeekMultiplier".	Stringa	Obbligatorio	Obbligatorio

CollectionResponse

Definisce un oggetto risposta per le richieste che ottengono un elenco di risorse.

Name	Valore	Tipo
valore	Elenco delle risorse richieste. A seconda della richiesta, l'elenco contiene uno dei tipi di oggetti seguenti: Hotel HotelGroup Subaccount HotelAssociation Ad esempio, se si richiede un elenco di gruppi di hotel, value contiene un elenco di HotelGroup oggetti.	object[]
@odata.count	Numero totale di entità risorsa disponibili, non il numero di entità in Value. La risposta include questo campo solo se si include il parametro di query $count nella richiesta.

DateTypeMultiplier

Definisce l'importo per modificare l'offerta di base se l'utente ha cercato hotel usando date specifiche.

Name	Valore	Tipo	Aggiunta	Update
Datetype	Tipo di data utilizzato nella ricerca. Di seguito sono riportati i possibili valori con distinzione tra maiuscole e minuscole. Impostazione predefinita: l'utente non ha cercato hotel con date specifiche Selezionato: l'utente ha cercato hotel utilizzando date specifiche.	String[]	Obbligatorio	Facoltativo
Fattore	Importo percentuale di cui modificare l'offerta di base. L'intervallo valido è compreso tra 0,00 e 10,00. Ad esempio, se l'offerta fissa è $5 e il moltiplicatore è 5, l'offerta finale è $25. Usando lo stesso moltiplicatore, se l'offerta percentuale è del 5% e la tariffa totale della stanza è $100, l'offerta finale è $25.	Double	Obbligatorio	Facoltativo
@odata.type	Tipo dell'oggetto. Questo campo è impostato su "#Model.DateTypeMultiplier".	Stringa	Obbligatorio	Obbligatorio

DeviceMultiplier

Definisce l'importo per modificare l'offerta di base se l'utente usa uno dei dispositivi specificati per cercare gli hotel.

Name	Valore	Tipo	Aggiunta	Update
DeviceTypes	Elenco dei tipi di dispositivo. Applicare il moltiplicatore se l'utente usa il tipo di dispositivo per cercare gli hotel. Di seguito sono riportati i possibili valori con distinzione tra maiuscole e minuscole. Desktop Dispositivi mobili Tablet	String[]	Obbligatorio	Facoltativo
Fattore	Importo percentuale di cui modificare l'offerta di base. L'intervallo valido è compreso tra 0,00 e 10,00. Ad esempio, se l'offerta fissa è $5 e il moltiplicatore è 5, l'offerta finale è $25. Usando lo stesso moltiplicatore, se l'offerta percentuale è del 5% e la tariffa totale della stanza è $100, l'offerta finale è $25.	Double	Obbligatorio	Facoltativo
@odata.type	Tipo dell'oggetto. Questo campo è impostato su "#Model.DeviceMultiplier".	Stringa	Obbligatorio	Obbligatorio

FixedBid

Definisce un importo fisso per l'offerta.

Name	Valore	Tipo	Aggiunta	Update
Quantità	Importo dell'offerta in dollari fissi. Per informazioni dettagliate sull'intervallo di offerte valido per il mercato, vedere la tabella Valore valuta nell'argomento Valute . L'account del cliente specifica la valuta utilizzata. L'importo dell'offerta è l'offerta per notte. Ad esempio, se l'offerta è di $ 3,50 e l'itinerario è per un soggiorno di 3 notti, l'offerta finale è $ 10,50.	Double	Obbligatorio	Facoltativo
@odata.type	Tipo dell'oggetto. Questo campo è impostato su "#Model.FixedBid".	Stringa	Obbligatorio	Obbligatorio

Hotel

Definisce un annuncio dell'hotel.

Name	Valore	Tipo	Aggiunta	Update
Offerta	Offerta di base. Microsoft usa questa offerta nell'asta a meno che non si specifichi uno o più moltiplicatori (vedere BidMultipliers). Se non si specifica un'offerta, l'hotel eredita l'offerta dal gruppo di hotel o dall'account secondario, in tale ordine. Quando si ottiene un hotel, se l'hotel non specifica un'offerta, questo campo contiene l'offerta ereditata. Di seguito sono riportati i tipi di offerte che è possibile specificare. FixedBid PercentageBid Per sospendere l'hotel, specificare una percentuale di offerta e impostare l'importo dell'offerta su zero (0). Per rimuovere l'offerta dell'hotel, impostare su Bid Null.	Oggetto	N/D	Facoltativo
BidMultipliers	Elenco di moltiplicatori da applicare all'offerta di base. Microsoft applica i moltiplicatori all'offerta di base e usa l'offerta rettificata nell'asta. Se l'hotel non specifica un'offerta, i moltiplicatori regolano l'offerta ereditata. Se non si specificano moltiplicatori, l'hotel li eredita dal gruppo di hotel o dall'account secondario, in questo ordine. Quando si ottiene un hotel, se l'hotel non specifica moltiplicatori, questo campo contiene i moltiplicatori ereditati. Se l'hotel specifica i moltiplicatori e si desidera rimuoverli, impostare su BidMultipliers una matrice vuota. Di seguito sono riportati i tipi di moltiplicatori che è possibile specificare. AdvanceBookingWindowMultiplier CheckinDayOfWeekMultiplier DateTypeMultiplier DeviceMultiplier LengthOfStayMultiplier SiteMultiplier UserCountryMultiplier	object[]	N/D	Facoltativo
BidMultiplierSource	Origine dei moltiplicatori di offerte. Di seguito sono riportati i valori possibili. Subaccount HotelGroup Hotel Ad esempio, se il gruppo di hotel e hotel non ha specificato moltiplicatori, l'hotel eredita i moltiplicatori dal sottoaccount. In questo caso, questo campo è impostato su SubAccount.	Stringa	N/D	Sola lettura
BidSource	Origine dell'offerta. Di seguito sono riportati i valori possibili. Subaccount HotelGroup Hotel Ad esempio, se l'hotel specifica un'offerta, questo campo viene impostato su Hotel.	Stringa	N/D	Sola lettura
CountryCode	Codice della contea ISO 3116 di due lettere del paese in cui si trova l'hotel. Il paese è lo stesso paese specificato per l'hotel nel file del feed dell'hotel.	Stringa	Sola lettura	Sola lettura
Id	ID generato dal sistema che identifica in modo univoco l'hotel.	Stringa	N/D	Obbligatorio
Nome	Il nome dell'hotel. Il nome è lo stesso nome specificato nel file del feed dell'hotel.	Stringa	N/D	Sola lettura
PartnerHotelId	ID usato per identificare l'hotel nel file dei feed dell'hotel.	Stringa	N/D	Sola lettura
Stato	Stato dell'entità dell'hotel. Di seguito sono riportati i valori possibili. Attivo: l'hotel non viene eliminato e può essere aggiornato. Eliminato: l'utente ha eliminato l'hotel. Gli utenti possono eliminare gli hotel solo usando l'interfaccia utente.	Stringa	N/D	Sola lettura

HotelAssociation

Definisce l'associazione tra un hotel e un gruppo di hotel.

La colonna Update contiene valori N/D perché non è disponibile alcuna operazione di aggiornamento HTTP. Per aggiornare l'associazione di un hotel, usare un'operazione Aggiungi (POST). Vedere il modello Associa .

Name	Valore	Tipo	Aggiunta	Update
Errori	Elenco dei motivi per cui la convalida dell'associazione non è riuscita. La risposta include questo campo solo se la convalida dell'associazione non è riuscita quando si è tentato di aggiungerla.	AdsApiError	Sola lettura	N/D
HotelGroupId	ID del gruppo di hotel a cui associare l'hotel.	Stringa	Obbligatorio	N/D
HotelGroupName	Nome del gruppo di hotel.	Stringa	Sola lettura	N/D
HotelId	ID dell'hotel da associare al gruppo di hotel specificato (vedere HotelGroupId). È possibile associare l'hotel a un solo gruppo di hotel. Per impostazione predefinita, tutti gli hotel sono associati a un gruppo di hotel, che si tratti di un gruppo definito dall'utente o del gruppo di hotel non raggruppato predefinito. Per spostare un hotel da un gruppo a un altro, pubblicare una nuova associazione che specifica l'ID hotel e il nuovo ID gruppo di hotel; il servizio rimuove l'associazione precedente.	Stringa	Obbligatorio	N/D
HotelName	Il nome dell'hotel.	Stringa	Sola lettura	N/D
PartnerHotelId	ID usato per specificare l'hotel nel file dei feed dell'hotel.	Stringa	Sola lettura	N/D

HotelGroup

Definisce un raggruppamento logico di hotel.

Name	Valore	Tipo	Aggiunta	Update
Offerta	Offerta di base ereditata dagli hotel del gruppo se non specificano un'offerta. Per l'utilizzo, vedere Bid nell'oggetto Hotel . Se non si specifica un'offerta, il gruppo eredita l'offerta dall'account secondario. Quando si ottiene un gruppo di hotel, se il gruppo non specifica un'offerta, questo campo contiene l'offerta ereditata. Di seguito sono riportati i tipi di offerte che è possibile specificare. FixedBid PercentageBid Per sospendere tutti gli hotel del gruppo, specificare una percentuale di offerta e impostare l'importo dell'offerta su zero (0). Per rimuovere l'offerta del gruppo, impostare su Bid Null.	Oggetto	Facoltativo	Facoltativo
BidMultipliers	Elenco di moltiplicatori ereditati dagli hotel nel gruppo se non specificano moltiplicatori. Per l'utilizzo, vedere BidMultipliers nell'oggetto Hotel . Se non si specificano moltiplicatori, il gruppo li eredita dal sottoaccount. Se il gruppo di hotel specifica i moltiplicatori e si desidera rimuoverli, impostare su BidMultipliers una matrice vuota. Di seguito sono riportati i tipi di moltiplicatori che è possibile specificare. AdvanceBookingWindowMultiplier CheckinDayOfWeekMultiplier DateTypeMultiplier DeviceMultiplier LengthOfStayMultiplier SiteMultiplier UserCountryMultiplier	object[]	Facoltativo	Facoltativo
BidMultiplierSource	Origine dei moltiplicatori di offerte. Di seguito sono riportati i valori possibili. Subaccount HotelGroup Ad esempio, se il gruppo di hotel non ha specificato moltiplicatori, il gruppo di hotel eredita i moltiplicatori dall'account secondario. In questo caso, questo campo è impostato su SubAccount.	Stringa	Sola lettura	Sola lettura
BidSource	Origine dell'offerta. Di seguito sono riportati i valori possibili. Subaccount HotelGroup Ad esempio, se il gruppo di hotel specifica moltiplicatori, questo campo viene impostato su HotelGroup.	Stringa	Sola lettura	Sola lettura
HotelAssociationCount	Numero di hotel associati al gruppo di hotel.	Unsigned Integer	Sola lettura	Sola lettura
Id	ID generato dal sistema che identifica in modo univoco il gruppo.	Stringa	Sola lettura	Obbligatorio
Nome	Nome del gruppo. Il nome può contenere un massimo di 256 caratteri.	Stringa	Obbligatorio	Sola lettura
Stato	Stato dell'entità del gruppo di hotel. Di seguito sono riportati i valori possibili. Attivo: il gruppo di hotel non viene eliminato e può essere aggiornato. Eliminato: l'utente ha eliminato il gruppo di hotel. Gli utenti possono eliminare gruppi di hotel usando solo l'interfaccia utente.	Stringa	Sola lettura	Sola lettura

LengthOfStayMultiplier

Definisce l'importo per modificare l'offerta di base se l'utente rimane il numero specificato di notti o più.

Name	Valore	Tipo	Aggiunta	Update
Fattore	Importo percentuale di cui modificare l'offerta di base. L'intervallo valido è compreso tra 0,00 e 10,00. Ad esempio, se l'offerta fissa è $5 e il moltiplicatore è 5, l'offerta finale è $25. Usando lo stesso moltiplicatore, se l'offerta percentuale è del 5% e la tariffa totale della stanza è $100, l'offerta finale è $25.	Double	Obbligatorio	Facoltativo
MinimumNumberOfNights	Numero minimo di notti necessarie per applicare il moltiplicatore. Applicare il moltiplicatore se l'utente rimane il numero specificato di notti o più. I valori validi sono compresi tra 1 e 14.	Numero intero	Obbligatorio	Facoltativo
@odata.type	Tipo dell'oggetto. Questo campo è impostato su "#Model.LengthOfStayMultiplier".	Stringa	Obbligatorio	Obbligatorio

Moltiplicatore

Definisce la classe di base per un moltiplicatore.

Non specificare questa classe, ma specificare una delle classi moltiplicatori, ad esempio UserCountryMultiplier.

Name	Valore	Tipo	Aggiunta	Update
Fattore	Importo percentuale di cui modificare l'offerta di base. L'intervallo valido è compreso tra 0,00 e 10,00. Ad esempio, se l'offerta fissa è $5 e il moltiplicatore è 5, l'offerta finale è $25. Usando lo stesso moltiplicatore, se l'offerta percentuale è del 5% e la tariffa totale della stanza è $100, l'offerta finale è $25.	Double	Obbligatorio	Facoltativo

PercentageBid

Definisce un'offerta in base alla percentuale della tariffa totale della camera per notte, incluse le tasse e altre tariffe.

Name	Valore	Tipo	Aggiunta	Update
Quantità	Importo dell'offerta percentuale. L'intervallo valido è compreso tra 0 e 1.000. Ad esempio, per fare un'offerta del 5% della tariffa totale della stanza, impostare su Amount 5,0. L'importo dell'offerta è l'offerta per notte. Ad esempio, se l'offerta è del 3%, la tariffa totale della camera è $ 99 e l'itinerario è per un soggiorno di 3 notti, quindi l'offerta finale è $ 8,91.	Double	Obbligatorio	Facoltativo
@odata.type	Tipo dell'oggetto. Questo campo è impostato su "#Model.PercentageBid".	Stringa	Obbligatorio	Obbligatorio

Processo report

Definisce un processo di report.

Name	Valore	Tipo	Aggiunta
Colonne	Elenco di colonne da includere nel report. L'ordine in cui sono inclusi nel report non è determinato. Il servizio di report può anche interfoliazione di altre colonne rilevanti non richieste in modo esplicito. Ai nomi delle colonne viene applicata la distinzione tra maiuscole e minuscole. Per un elenco dei nomi di colonna, vedere Colonne del report per il tipo di report richiesto. Ad esempio, per PerformanceReport, vedere Colonne del report prestazioni. Le colonne devono includere in fase di lease una colonna di tipo dimensione e una colonna di tipo metrica.	String[]	Obbligatorio
Compressione	Tipo di compressione da applicare al report. Di seguito sono riportati i possibili valori senza distinzione tra maiuscole e minuscole. ZIP Il valore predefinito non è la compressione.	Stringa	Facoltativo
EndDate	Data di fine UTC del report nel formato AAAA-MM-gg. Il mese e il giorno devono contenere due cifre. Ad esempio, invece di 2018-1-4 usare 2018-01-04. Il report contiene dati che rientrano nelle date di inizio e fine, inclusi. La data di fine deve essere successiva o successiva alla data di inizio. NOTA: Durante il polling per ottenere lo stato del processo, il servizio restituisce la data nel formato AAAA-MM-ddTHH:mm:ssZ (ad esempio, 2017-10-30T00:00:00Z).	Stringa	Obbligatorio
Filtro	Stringa di filtro OData da applicare. La lunghezza massima della stringa di filtro è di 1.000 caratteri. Per informazioni sull'uso dei filtri, vedere Filtrare i dati del report. NOTA: I nomi delle colonne del report e i valori di enumerazione specificati fanno distinzione tra maiuscole e minuscole. Ad esempio, è necessario specificare DeviceType anziché devicetype e Desktop anziché desktop.	Stringa	Facoltativo
Formato	Formato del contenuto nel report. Di seguito sono riportati i possibili valori senza distinzione tra maiuscole e minuscole. CSV Il valore predefinito è CSV.	Stringa	Facoltativo
HotelGroupId	ID dell'hotel a cui limitare il report. Per impostare questo campo, è anche necessario impostare SubaccountId.	Stringa	Facoltativo
Id	ID che identifica in modo univoco il processo del report.	Stringa	Sola lettura
IncludeNonPerformingHotels	Valore booleano che determina se il report include hotel che non hanno ricevuto impressioni durante il periodo di report. Per includere gli hotel senza prestazioni, impostare questo campo su true; in caso contrario, false. Il valore predefinito è false. Per limitazioni sulle colonne che è possibile specificare durante la richiesta di hotel senza prestazioni, vedere Inclusione di hotel non con prestazioni nel report.	Booleano	Facoltativo
ReportType	Tipo di entità o report da scaricare. Di seguito sono riportati i possibili valori con distinzione tra maiuscole e minuscole. Prestazioni	Stringa	Obbligatorio
StartDate	Data di inizio UTC del report nel formato AAAA-MM-gg. Il mese e il giorno devono contenere due cifre. Ad esempio, 2018-1-4 deve essere 2018-01-04. La data più recente che è possibile specificare è di tre anni a partire da oggi. NOTA: Durante il polling per ottenere lo stato del processo, il servizio restituisce la data nel formato AAAA-MM-ddTHH:mm:ssZ (ad esempio, 2017-10-30T00:00:00Z).	Stringa	Obbligatorio
Stato	Stato del processo del report. Di seguito sono riportati i valori possibili. Completato: il processo del report è stato completato correttamente. Usare l'URL nel Url campo per scaricare il report. Non riuscito: il processo non è riuscito per qualche motivo. Nel caso in cui l'errore sia temporaneo, è possibile inviare nuovamente il processo. Se il processo ha nuovamente esito negativo, acquisire l'ID richiesta nell'intestazione X-MS-RequestId e contattare il supporto tecnico. InProgress: il servizio è in fase di compilazione del report. PendingExecution: la richiesta del report è in coda	Stringa	Sola lettura
SubaccountId	ID dell'account secondario a cui limitare il report.	Stringa	Facoltativo
Url	URL del report da scaricare. Il servizio fornisce l'URL quando Status è Completato. L'URL è valido per cinque (5) minuti dal momento in cui si ottiene un processo di report con Status impostato su Completato. Se l'URL scade, inviare una richiesta GET per ottenere di nuovo lo stato del processo e un nuovo URL.

SiteMultiplier

Definisce l'importo per modificare l'offerta di base se l'utente sta cercando hotel in uno dei siti Bing specificati.

Name	Valore	Tipo	Aggiunta	Update
Fattore	Importo percentuale di cui modificare l'offerta di base. L'intervallo valido è compreso tra 0,00 e 10,00. Ad esempio, se l'offerta fissa è $5 e il moltiplicatore è 5, l'offerta finale è $25. Usando lo stesso moltiplicatore, se l'offerta percentuale è del 5% e la tariffa totale della stanza è $100, l'offerta finale è $25.	Double	Obbligatorio	Facoltativo
Siti	Elenco di siti. Applicare il moltiplicatore se l'utente usa il sito specificato per cercare gli hotel. Di seguito sono riportati i possibili valori con distinzione tra maiuscole e minuscole. LocalUniversal: l'utente sta cercando hotel in Bing.com. MapResults: l'utente sta cercando hotel in Bing.com/maps. PropertyPromotionAd: la prima pagina dei risultati visualizzata nella ricerca delle mappe.	String[]	Obbligatorio	Facoltativo
@odata.type	Tipo dell'oggetto. Questo campo è impostato su "#Model.SiteMultiplier".	Stringa	Obbligatorio	Obbligatorio

Subaccount

Definisce il raggruppamento di annunci di prezzo dell'hotel di primo livello. Si può pensare a questo logicamente come una campagna di alloggio.

Name	Valore	Tipo	Aggiunta	Update
Offerta	L'offerta di base che gli hotel ereditano se essi, o il gruppo a cui appartengono, non specificano un'offerta. Per l'utilizzo, vedere Bid nell'oggetto Hotel . Di seguito sono riportati i tipi di offerte che è possibile specificare. FixedBid PercentageBid Per sospendere tutti gli hotel nel sottoaccount, specificare una percentuale di offerta e impostare l'importo dell'offerta su zero (0).	Oggetto	Obbligatorio	Facoltativo
BidMultipliers	Un elenco di moltiplicatori che gli hotel ereditano se, o il gruppo a cui appartengono, non specificano i moltiplicatori. Il valore predefinito è 0. Per l'utilizzo, vedere BidMultipliers nell'oggetto Hotel . Se il sottoaccount specifica i moltiplicatori e si desidera rimuoverli, impostare su BidMultipliers una matrice vuota. Di seguito sono riportati i tipi di moltiplicatori che è possibile specificare. AdvanceBookingWindowMultiplier CheckinDayOfWeekMultiplier DateTypeMultiplier DeviceMultiplier LengthOfStayMultiplier SiteMultiplier UserCountryMultiplier	object[]	Facoltativo	Facoltativo
DailyBudget	Il budget giornaliero da distribuire durante la giornata. L'impostazione del budget su 0 impedisce la gestione degli hotel nell'account secondario.	Bilancio	Obbligatorio	Facoltativo
HotelAssociationCount	Numero di hotel associati ai gruppi di hotel nell'account secondario.	Unsigned Integer	Sola lettura	Sola lettura
Id	ID generato dal sistema che identifica in modo univoco il sottoaccount.	Stringa	Sola lettura	Obbligatorio
MaximumBid	Importo dell'offerta da non superare.	FixedBid	Facoltativo	Facoltativo
Nome	Nome dell'account secondario. Il nome può contenere un massimo di 128 caratteri.	Stringa	Obbligatorio	Sola lettura
Stato	Stato dell'entità dell'account secondario. Di seguito sono riportati i valori possibili. Attivo: l'account secondario non viene eliminato e può essere aggiornato. Eliminato: l'utente ha eliminato l'account secondario. Gli utenti possono eliminare gli account secondari solo usando l'interfaccia utente.	Stringa	Sola lettura	Sola lettura

UserCountryMultiplier

Definisce l'importo per modificare l'offerta di base se l'utente accede a uno dei domini Bing.

Name	Valore	Tipo	Aggiunta	Update
Paesi	Elenco di codici paese ISO 3116 a due lettere. Per un elenco dei possibili codici paese/area geografica, vedere Codici paese/area geografica consentiti. Applicare il moltiplicatore se l'utente accede al dominio Bing con il codice paese specificato. Ad esempio, se l'elenco include US e DE, Microsoft usa il moltiplicatore se l'utente usa Bing.com con il codice us o de country (ad esempio, bing.com?cc=de).	String[]	Obbligatorio	Facoltativo
Fattore	Importo percentuale di cui modificare l'offerta di base. L'intervallo valido è compreso tra 0,00 e 10,00. Ad esempio, se l'offerta fissa è $5 e il moltiplicatore è 5, l'offerta finale è $25. Usando lo stesso moltiplicatore, se l'offerta percentuale è del 5% e la tariffa totale della stanza è $100, l'offerta finale è $25.	Double	Obbligatorio	Facoltativo
@odata.type	Tipo dell'oggetto. Questo campo è impostato su "#Model.UserCountryMultiplier".	Stringa	Obbligatorio	Obbligatorio

Codici di stato HTTP

Le richieste possono restituire i codici di stato HTTP seguenti.

Codice di stato	Descrizione
200	La risorsa è stata recuperata correttamente.
201	Aggiunta della risorsa completata.
204	Aggiornamento o eliminazione della risorsa completata.
400	Richiesta non valida. Il valore di un parametro di query non è valido o il contenuto nel corpo della richiesta non è valido.
401	Non autorizzato. Le credenziali dell'utente non sono valide.
403	Proibito. L'URL di download per il report è scaduto. Sono disponibili sette giorni dal momento in cui si ottiene l'URL per scaricare il report. Se l'URL scade, è necessario inviare una nuova richiesta di processo.
404	Non trovato.
429	Troppe richieste. L'API limita il numero di richieste che è possibile effettuare al minuto. Il limite non è documentato ed è soggetto a modifiche. L'API restituisce questo codice di stato se si supera il limite. È necessario attendere 60 dopo aver ricevuto questo errore prima di inviare nuovamente la richiesta.
500	Errore del server.

Codici di errore

Segnalazione di codici di errore

Codice errore	Descrizione
CompressionTypeNotSupported	Il Compression campo è impostato su un valore non supportato. Per un elenco degli algoritmi di compressione supportati, vedere Compressione.
Valori duplicati	Il campo Colonne contiene più volte lo stesso nome di colonna.
FilterTooLong	La stringa di filtro OData impostata su Filter è troppo lunga. Per la lunghezza massima consentita, vedere Filtro.
FormatVersionNotSupported	Il Format campo è impostato su un valore non supportato. Per un elenco dei formati supportati, vedere Formato.
InvalidDateRange	Il periodo di report specificato non è valido. Per informazioni su come specificare un intervallo di date valido, vedere i campi StarteDate e EndDate .
InvalidReportName	Il ReportType campo è impostato su un nome di report non valido. Per un elenco di nomi di report validi, vedere ReportType.
InvalidSelect	Una o più colonne specificate non sono valide. Confrontare i nomi di colonna usati con quelli documentati per il report richiesto. Tenere presente che i nomi fanno distinzione tra maiuscole e minuscole.

Codici paese o area geografica

È possibile utilizzare i codici paese/area geografica seguenti per impostare il Countries campo UserCountryMultiplier.

Nome paese/area geografica	Codice paese/area geografica
Afghanistan	AF
Albania	AL
Algeria	DZ
Andorra	ANNUNCIO
Angola	AO
Anguilla	Intelligenza artificiale
Antartide	AQ
Antigua e Barbuda	AG
Antille (Paesi Bassi)	UN
Samoa americane	COME
Argentina	AR
Armenia	AM
Aruba	AW
Australia	AU
Austria	AT
Azerbaigian	AZ
Bahamas	B
Bahrein	BH
Bangladesh	BD
Barbados	BB
Bielorussia	BY
Belgio	BVE
Belize	BZ
Bermuda	BM
Benin	BJ
Bhutan	BT
Bolivia	BO
Bosnia ed Erzegovina	BA
Botswana	BW
Brasile	BR
Brunei	MLD
Bulgaria	BG
Burkina Faso	BF
Burundi	BI
Cabo Verde	CV
Cambogia	KH
Camerun	CM
Canada	CA
Isole Cayman	KY
Repubblica Centrafricana	CFR
Ciad	TD
Cile	CL
Cina	CN
Isola Christmas	CX
Isole Cocos	CC
Colombia	CO
Comore	KM
Congo	CG
Congo (Repubblica Democratica del)	CD
Isole Cook	CK
Costa Rica	CR
Côte d'Ivoire	CI
Croazia	Risorse umane
Cipro	CY
Repubblica Ceca	CZ
Danimarca	DK
Gibuti	DJ
Dominica	DM
Repubblica dominicana	FARE
Ecuador	CE
Egitto	Ad esempio
El Salvador	SV
Guinea Equatoriale	GQ
Eritrea	ER
Estonia	EE
Eswatini	SZ
Etiopia	ET
Isole Falkland	FK
Isole Fær Øer	FO
Figi	FJ
Finlandia	FI
Francia	FR
Guyana francese	MOROSA
Polinesia francese	PF
Gabon	GA
Gambia	GM
Georgia	GE
Germania	DE
Ghana	GH
Gibilterra	GI
Grecia	GR
Groenlandia	GL
Grenada	GD
Guadalupa	GP
Guam	GU
Guatemala	GT
Guinea	GN
Guinea-Bissau	GW
Guyana	GY
Haiti	HT
Santa Sede	VIRGINIA
Honduras	HN
RAS di Hong Kong	HK
Ungheria	HU
Islanda	Sicurezza informazioni
India	POLLICI
Indonesia	ID
Iraq	IQ
Irlanda	IE
Israele	IL
Italia	IT
Giamaica	JM
Giappone	JP
Giordania	JO
Kazakistan	KZ
Kenya	KE
Kiribati	KI
Corea	KR
Kuwait	KW
Kirghizistan	KG
Repubblica Democratica del Lao Persone	LA
Lettonia	LV
Libano	LB
Lesotho	LS
Liberia	LR
Libia	LY
Liechtenstein	LI
Lituania	TENENTE
Lussemburgo	LU
Macao SAR	MO
Madagascar	MG
Malawi	MW
Malaysia	MIO
Maldive	MV
Mali	ML
Malta	MONTE
Isole Marshall	MH
Martinica	MQ
Mauritania	SIGNOR
Mauritius	MU
Mayotte	YT
Messico	MX
Micronesia	FM
Moldova	MD
Monaco	MC
Mongolia	MN
Montenegro	ME
Montserrat	SIGNORA
Marocco	MA
Mozambico	MZ
Myanmar	MM
Namibia	ND
Nauru	NR
Nepal	NP
Paesi Bassi	NL
Nuova Caledonia	NC
Nuova Zelanda	NZ
Nicaragua	NI
Niger	NE
Nigeria	NG
Niue	NU
Isola Norfolk	NF
Norvegia	NO
Macedonia del Nord	MK
Isole Marianne settentrionali	MP
Oman	OM
Pakistan	PK
Palau	PW
Autorità Palestinese	PS
Panamá	PA
Papua Nuova Guinea	PG
Paraguay	PY
Perù	PE
Filippine	PH
Isole Pitcairn	PN
Polonia	PL
Portogallo	PT
Portorico	PR
Qatar	QA
Riunione	RE
Romania	RO
Federazione russa	RU
Ruanda	RW
Sant'Elena, Ascensione e Tristan da Cunha	SH
Saint Kitts e Nevis	KN
Saint Lucia	LC
Saint-Pierre e Miquelon	PM
Saint Vincent e Grenadine	VC
San Marino	SM
São Tomé e Príncipe	SAN
Arabia Saudita	SA
Senegal	SN
Serbia	RS
Seychelles	M.B
Sierra Leone	SL
Singapore	SG
Slovacchia	SK
Slovenia	SI
Spagna	ES
Isole Salomone	SB
Samoa	WS
Somalia	COSÌ
Sudafrica	ZA
Sri Lanka	LK
Suriname	SUOR
Svezia	SE
Svizzera	CH
Taiwan	TW
Tagikistan	TJ
Tanzania	TZ
Thailandia	TH
Timor Est	TL
Togo	TG
Tokelau	TK
Tonga	A
Trinidad e Tobago	TT
Tunisia	TN
Türkiye	TR
Turkmenistan	TM
Isole Turks e Caicos	TC
Tuvalu	TV
Uganda	UG
Ucraina	UA
Emirati Arabi Uniti	AE
Regno Unito	GB
Stati Uniti	IT
Uruguay	UY
Uzbekistan	UZ
Vanuatu	VU
Venezuela	VE
Vietnam	VN
Isole Vergini (Regno Unito)	VG
Isole Vergini (Stati Uniti)	VI
Wallis e Futuna	WF
Yemen	VOI
Zambia	ZM
Zimbabwe	ZW