Condividi tramite

Oggetto dati ClientLink - Gestione clienti

  • Articolo

Definisce un oggetto collegamento client. L'accettazione di un invito al collegamento client consente a un'agenzia di gestire gli account dell'inserzionista client corrispondente. Per inviare un invito a gestire un account inserzionista client, chiamare l'operazione AddClientLinks e specificare un collegamento client per ogni account da gestire.

Un collegamento client non ha un identificatore di sistema pubblico. È possibile identificare collegamenti client distinti in base a ClientEntityId e ManagingCustomerId.

Consiglio

Per altre informazioni sul ciclo di vita dei collegamenti client, vedere la guida tecnica relativa alla gerarchia degli account . Per altre informazioni su come diventare un'agenzia, vedere Risorse per i partner dell'agenzia. Per altre informazioni dal punto di vista di un cliente, vedere Come fare in modo che un'agenzia gestisa l'account Microsoft Advertising.

Nota

I clienti dell'agenzia nel progetto pilota Create Accounts on Behalf of Client (GetCustomerPilotFeatures restituisce 793) possono anche stabilire collegamenti client a livello di account pubblicitario tramite l'operazione di servizio SignupCustomer . Per altre informazioni, vedere SignupCustomer .

Sintassi

<xs:complexType name="ClientLink" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Type" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ClientEntityId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="ClientEntityNumber" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ClientEntityName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ManagingCustomerId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="ManagingCustomerNumber" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ManagingCustomerName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Note" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="InviterEmail" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="InviterName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="InviterPhone" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="IsBillToClient" nillable="true" type="xs:boolean" />
    <xs:element minOccurs="0" name="StartDate" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:ClientLinkStatus" />
    <xs:element minOccurs="0" name="SuppressNotification" type="xs:boolean" />
    <xs:element minOccurs="0" name="LastModifiedDateTime" type="xs:dateTime" />
    <xs:element minOccurs="0" name="LastModifiedByUserId" type="xs:long" />
    <xs:element minOccurs="0" name="Timestamp" nillable="true" type="xs:base64Binary" />
    <xs:element xmlns:q10="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q10:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="CustomerLinkPermission" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

Elementi

L'oggetto ClientLink include gli elementi seguenti: ClientEntityId, ClientEntityName, ClientEntityNumber, CustomerLinkPermission, ForwardCompatibilityMap, InviterEmail, InviterName, InviterPhone, IsBillToClient, LastModifiedByUserId, LastModifiedDateTime, ManagingCustomerId, ManagingCustomerName, ManagingCustomerNumber, Name, Note, StartDate, Status, SuppressNotification, Timestamp, Type.

Elemento Descrizione Tipo di dati
ClientEntityId Identificatore dell'account dell'inserzionista client o del cliente cliente da gestire

L'elemento Type determina se il collegamento è a un account dell'inserzionista client o a un cliente client.

Aggiungere: Obbligatorio. ClientEntityId o ClientEntityNumber è obbligatorio, ma se si specificano entrambi, l'operazione avrà esito negativo.
Aggiornare: Sola lettura e Obbligatorio.		 long
ClientEntityName Nome dell'account dell'inserzionista del cliente o del cliente da gestire

L'elemento Type determina se il collegamento è a un account dell'inserzionista client o a un cliente client.

Aggiungere: Sola lettura
Aggiornare: Sola lettura		 corda
ClientEntityNumber Numero dell'account dell'inserzionista del cliente o del cliente da gestire

L'elemento Type determina se il collegamento è a un account dell'inserzionista client o a un cliente client.

Aggiungere: Obbligatorio. ClientEntityId o ClientEntityNumber è obbligatorio, ma se si specificano entrambi, l'operazione avrà esito negativo.
Aggiornare: Sola lettura e Obbligatorio.		 corda
CustomerLinkPermission Determina se l'accesso dell'utente agli account è limitato dalla gerarchia dei clienti, ad esempio dal collegamento client a livello di cliente.

Questo elemento è applicabile solo se Type è impostato su CustomerLink. In tal caso, i valori possibili includono Administrative e Standard. In caso contrario, questo campo deve essere nil o vuoto.

Se questo campo è impostato su "Administrative", l'utente ha accesso a ClientEntityId tramite un collegamento del cliente amministrativo.

Se questo campo è impostato su "Standard", l'utente ha accesso a ClientEntityId tramite un collegamento al cliente Standard.

ClientEntityId fa parte di una gerarchia di collegamenti del cliente in base alla quale l'utente può accedere ad altri clienti al di sotto di esso.

Per altre informazioni, vedere la Guida tecnica per i ruoli utente .

Aggiungere: Opzionale
Aggiornare: Sola lettura		 corda
ForwardCompatibilityMap Elenco di stringhe di chiave e valore per la compatibilità con l'inoltro per evitare modifiche che altrimenti causano un'interruzione quando vengono aggiunti nuovi elementi nella versione corrente dell'API.

Le modifiche di compatibilità forward verranno annotate qui nelle versioni future. Attualmente non sono presenti modifiche di compatibilità per l'oggetto ClientLink .		 Matrice KeyValuePairOfstringstring
InviterEmail Messaggio di posta elettronica dell'utente che ha creato la richiesta di collegamento client.

Non è necessario che questo valore corrisponda né venga usato per modificare il messaggio di posta elettronica già archiviato in Microsoft Advertising per l'utente autenticato corrente.

Se non specificato, il servizio imposterà questo valore sul messaggio di posta elettronica già archiviato in Microsoft Advertising per l'utente autenticato corrente.

Aggiungere: Opzionale
Aggiornare: Sola lettura		 corda
InviterName Nome del cliente padre dell'utente che ha creato la richiesta di collegamento client.

Questo valore non deve necessariamente corrispondere al nome del cliente già archiviato in Microsoft Advertising né viene usato per modificarlo.

Se non specificato, il servizio imposterà questo valore sul nome del cliente padre già archiviato in Microsoft Advertising per l'utente autenticato corrente.

Aggiungere: Opzionale
Aggiornare: Sola lettura		 corda
InviterPhone Numero di telefono dell'utente che ha creato la richiesta di collegamento client.

Non è necessario che questo valore corrisponda né venga usato per modificare il numero di telefono già archiviato in Microsoft Advertising per l'utente autenticato corrente.

Se non specificato, il servizio imposterà questo valore sul numero di telefono già archiviato in Microsoft Advertising per l'utente autenticato corrente.

Aggiungere: Opzionale
Aggiornare: Sola lettura		 corda
IsBillToClient Determina se il proprietario dell'account dell'inserzionista client o del cliente gestito è responsabile dei pagamenti di fatturazione.

Questo elemento è applicabile solo ai collegamenti client dell'account dell'inserzionista e non ai collegamenti dei clienti. L'account dell'inserzionista client deve essere configurato per la fatturazione post-pagamento. Gli account prepagati non sono supportati per la gestione da parte delle agenzie. Se impostato su true, il client è responsabile della fatturazione. Se impostato su false, il cliente che gestisce è responsabile della fatturazione.

Aggiungere: Obbligatorio per i collegamenti all'account dell'inserzionista; Non applicabile per i collegamenti dei clienti.
Aggiornare: Sola lettura		 booleano
LastModifiedByUserId Identificatore dell'ultimo utente per aggiornare le informazioni del collegamento client.

Aggiungere: Sola lettura
Aggiornare: Sola lettura		 long
LastModifiedDateTime Data e ora dell'ultimo aggiornamento del collegamento client. Il valore è espresso nell'ora UTC (Coordinated Universal Time).

Il valore di data e ora riflette la data e l'ora nel server, non nel client. Per informazioni sul formato della data e dell'ora, vedere la voce dateTime in Tipi di dati XML primitivi.

Aggiungere: Sola lettura
Aggiornare: Sola lettura		 dateTime
ManagingCustomerId Identificatore del cliente che gestisce o richiede di gestire l'account dell'inserzionista client.

Aggiungere: Obbligatorio. ManagingCustomerId o ManagingCustomerNumber è obbligatorio, ma se si specificano entrambi, l'operazione avrà esito negativo.
Aggiornare: Sola lettura e Obbligatorio		 long
ManagingCustomerName Nome del cliente che gestisce o richiede di gestire l'account dell'inserzionista client.

Aggiungere: Sola lettura
Aggiornare: Sola lettura		 corda
ManagingCustomerNumber Numero del cliente che gestisce o richiede di gestire l'account dell'inserzionista client.

Aggiungere: Obbligatorio. ManagingCustomerId o ManagingCustomerNumber è obbligatorio, ma se si specificano entrambi, l'operazione avrà esito negativo.
Aggiornare: Sola lettura e Obbligatorio		 corda
Nome Nome descrittivo che può essere usato per fare riferimento a questo collegamento client.

Il nome può contenere un massimo di 40 caratteri.

Se non ne viene specificato alcuno, verrà specificato un nome predefinito. Non è necessario che il nome sia univoco rispetto ad altri collegamenti client per l'utente.

Aggiungere: Opzionale
Aggiornare: Sola lettura		 corda
Nota Messaggio facoltativo del richiedente che fornisce contesto e dettagli sull'invito al collegamento client.

Aggiungere: Opzionale
Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.		 corda
StartDate Data di aggiornamento dello stato. Per una richiesta di collegamento accettata, lo stato passa a Attivo in questa data e per una richiesta di scollegare lo stato passa a Inattivo in questa data.

Se non specificato, questo valore verrà impostato sulla data e l'ora correnti.

Aggiungere: Opzionale
Aggiornare: Sola lettura		 dateTime
Stato Determina lo stato del ciclo di vita del collegamento client, ad esempio se il collegamento client è stato accettato o rifiutato.

Quando si aggiunge un collegamento client non è possibile specificare questo elemento e il servizio imposta lo stato effettivo su LinkPending.

Aggiungere: Sola lettura
Aggiornare: Obbligatorio		 ClientLinkStatus
SuppressNotification Determina se inviare o meno una notifica tramite posta elettronica dell'invito al collegamento client all'utente primario dell'account dell'inserzionista client.

Se impostato su true il client non riceverà un messaggio di posta elettronica e in caso contrario, poiché il valore predefinito è false, il client riceverà una notifica tramite posta elettronica.

Aggiungere: Opzionale
Aggiornare: Sola lettura		 booleano
Data e ora Parametro riservato per utilizzi futuri. base64Binary
Tipo Determina se il collegamento è a un account dell'inserzionista client o a un cliente client.

I valori possibili sono AccountLink e CustomerLink. Se questo elemento è vuoto o impostato su AccountLink, ClientEntityId, ClientEntityName e ClientEntityNumber rappresentano un account inserzionista client. Se questo elemento è impostato su CustomerLink, ClientEntityId, ClientEntityName e ClientEntityNumber rappresentano un cliente client.

Aggiungere: Opzionale. Se questo elemento non è impostato, il servizio tenta di creare un collegamento client dell'account dell'inserzionista.
Aggiornare: Sola lettura		 corda

Requisiti

Servizio: CustomerManagementService.svc v13
Spazio dei nomi: https://bingads.microsoft.com/Customer/v13/Entities

Usato da

AddClientLinks
SearchClientLinks
UpdateClientLinks