Aracılığıyla paylaş

ClientLink Veri Nesnesi - Müşteri Yönetimi

  • Makale

İstemci bağlantı nesnesini tanımlar. İstemci bağlantısı davetinin kabul edilmesi, bir kuruluşun ilgili müşteri reklamveren hesaplarını yönetmesine olanak tanır. Bir istemci reklamveren hesabını yönetme daveti göndermek için AddClientLinks işlemini çağırın ve yönetecek hesap başına bir istemci bağlantısı belirtin.

İstemci bağlantısının genel sistem tanımlayıcısı yoktur. ClientEntityId ve ManagingCustomerId değerlerine göre ayrı istemci bağlantılarını tanımlayabilirsiniz.

İpucu

İstemci bağlantısı yaşam döngüsü hakkında daha fazla bilgi için Hesap Hiyerarşisi teknik kılavuzuna bakın. Ajans olma hakkında daha fazla bilgi için bkz. Ajans iş ortakları için kaynaklar. Müşteri açısından daha fazla bilgi için bkz. Microsoft Advertising hesabınızı bir ajansın yönetmesini sağlama.

Not

İstemci pilotu adına Hesap Oluşturma (GetCustomerPilotFeatures 793 döndürür) aracı müşterileri, SignupCustomer hizmeti işlemi aracılığıyla reklam hesabı düzeyinde istemci bağlantıları da oluşturabilir. Daha fazla bilgi için lütfen SignupCustomer bölümüne bakın.

Sözdizimi

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

Öğe

ClientLink nesnesi şu öğelere sahiptir: ClientEntityId, ClientEntityName, ClientEntityNumber, CustomerLinkPermission, ForwardCompatibilityMap, InviterEmail, InviterName, InviterPhone, IsBillToClient, LastModifiedByUserId, LastModifiedDateTime, ManagingCustomerId, ManagingCustomerName, ManagingCustomerNumber, Ad, Not, BaşlangıçTarihi, Durum, SuppressNotification, Zaman Damgası, Tür.

Öğe Açıklama Veri Türü
ClientEntityId Yönetecek istemci reklamveren hesabının veya müşteri müşterisinin tanımlayıcısı

Type öğesi, bağlantının bir müşteri reklamveren hesabına mı yoksa müşteri müşterisine mi olduğunu belirler.

Eklemek: Gerekli. ClientEntityId veya ClientEntityNumber gereklidir, ancak her ikisinin belirtilmesi işlemin başarısız olmasına neden olur.
Güncelleştirmek: Salt okunur ve Gerekli.		 uzun
ClientEntityName Yönetecek müşteri reklamveren hesabının veya müşterisinin adı

Type öğesi, bağlantının bir müşteri reklamveren hesabına mı yoksa müşteri müşterisine mi olduğunu belirler.

Eklemek: Salt okunur
Güncelleştirmek: Salt okunur		 dizgi
ClientEntityNumber Yönetecek müşteri reklamveren hesabının veya müşterisinin sayısı

Type öğesi, bağlantının bir müşteri reklamveren hesabına mı yoksa müşteri müşterisine mi olduğunu belirler.

Eklemek: Gerekli. ClientEntityId veya ClientEntityNumber gereklidir, ancak her ikisinin belirtilmesi işlemin başarısız olmasına neden olur.
Güncelleştirmek: Salt okunur ve Gerekli.		 dizgi
CustomerLinkPermission Kullanıcının hesaplara erişiminin müşteri hiyerarşisi ile kısıtlanıp kısıtlanmadığını belirler; örneğin, müşteri düzeyinde istemci bağlama.

Bu öğe yalnızca Tür CustomerLink olarak ayarlandıysa geçerlidir. Bu durumda, olası değerler Yönetim ve Standart değerlerini içerir. Aksi takdirde bu alan sıfır veya boş olmalıdır.

Bu alan "Yönetim" olarak ayarlanırsa, kullanıcının Bir Yönetici müşteri bağlantısı üzerinden ClientEntityId'ye erişimi olur.

Bu alan "Standart" olarak ayarlanırsa, kullanıcının Standart müşteri bağlantısı üzerinden ClientEntityId'ye erişimi olur.

ClientEntityId, kullanıcının altındaki diğer müşterilere erişebildiği bir müşteri bağlantı hiyerarşisinin parçasıdır.

Daha fazla bilgi için bkz. Kullanıcı Rolleri teknik kılavuzu.

Eklemek: Opsiyonel
Güncelleştirmek: Salt okunur		 dizgi
İletme Uyumluluğu Haritası Geçerli API sürümüne yeni öğeler eklendiğinde başka değişikliklerden kaçınmak için ileriye dönük uyumluluk için anahtar ve değer dizelerinin listesi.

İleriye dönük uyumluluk değişiklikleri gelecek sürümlerde burada not alınacaktır. Şu anda ClientLink nesnesi için ileriye dönük uyumluluk değişikliği yoktur.		 KeyValuePairOfstringstring dizisi
InviterEmail İstemci bağlantı isteğini oluşturan kullanıcının e-postası.

Bu değerin, geçerli kimliği doğrulanmış kullanıcı için Microsoft Advertising'te depolanan e-postayla aynı olması ve değiştirmek için kullanılması gerekmez.

Belirtilmezse, hizmet bu değeri geçerli kimliği doğrulanmış kullanıcı için Microsoft Advertising'te depolanan e-postaya ayarlar.

Eklemek: Opsiyonel
Güncelleştirmek: Salt okunur		 dizgi
InviterName İstemci bağlantı isteğini oluşturan kullanıcının üst müşterisinin adı.

Bu değerin, Microsoft Advertising'te depolanan müşteri adıyla aynı olması veya değiştirmek için kullanılması gerekmez.

Belirtilmezse, hizmet bu değeri geçerli kimliği doğrulanmış kullanıcı için Zaten Microsoft Advertising'te depolanan üst müşteri adına ayarlar.

Eklemek: Opsiyonel
Güncelleştirmek: Salt okunur		 dizgi
Davetli Telefonu İstemci bağlantı isteğini oluşturan kullanıcının telefon numarası.

Bu değerin, geçerli kimliği doğrulanmış kullanıcı için Microsoft Advertising'te depolanan telefon numarasıyla aynı olması ve değiştirmek için kullanılması gerekmez.

Belirtilmezse, hizmet bu değeri geçerli kimliği doğrulanmış kullanıcı için Microsoft Advertising'te depolanan telefon numarasına ayarlar.

Eklemek: Opsiyonel
Güncelleştirmek: Salt okunur		 dizgi
IsBillToClient Ödemelerden müşteri reklamveren hesabının sahibinin mi yoksa yöneten müşterinin mi sorumlu olduğunu belirler.

Bu öğe yalnızca reklamveren hesabı istemci bağlantıları için geçerlidir ve müşteri bağlantıları için geçerli değildir. Müşteri reklamveren hesabı, ödeme sonrası ödeme için ayarlanmalıdır. Ön ödemeli hesaplar, kurumlar tarafından yönetim için desteklenmez. True olarak ayarlanırsa faturalamadan istemci sorumludur. False olarak ayarlanırsa faturalamadan yönetici müşteri sorumludur.

Eklemek: Reklamveren hesabı bağlantıları için gerekli; Müşteri bağlantıları için geçerli değildir.
Güncelleştirmek: Salt okunur		 Boolean
LastModifiedByUserId İstemci bağlantısının bilgilerini güncelleştiren son kullanıcının tanımlayıcısı.

Eklemek: Salt okunur
Güncelleştirmek: Salt okunur		 uzun
LastModifiedDateTime İstemci bağlantısının son güncelleştirildiği tarih ve saat. Değer Eşgüdümlü Evrensel Saat (UTC) içindedir.

Tarih ve saat değeri, istemcide değil sunucudaki tarih ve saati yansıtır. Tarih ve saatin biçimi hakkında bilgi için temel XML Veri Türleri'ndeki dateTime girdisine bakın.

Eklemek: Salt okunur
Güncelleştirmek: Salt okunur		 dateTime
ManagingCustomerId müşteri reklamvereni hesabını yöneten veya yönetmek isteyen müşterinin tanımlayıcısı.

Eklemek: Gerekli. ManagingCustomerId veya ManagingCustomerNumber gereklidir, ancak her ikisinin belirtilmesi işlemin başarısız olmasına neden olur.
Güncelleştirmek: Salt okunur ve Gerekli		 uzun
ManagingCustomerName Müşteri reklamveren hesabını yöneten veya yönetmek isteyen müşterinin adı.

Eklemek: Salt okunur
Güncelleştirmek: Salt okunur		 dizgi
ManagingCustomerNumber müşteri reklamvereni hesabını yöneten veya yönetmek isteyen müşterinin sayısı.

Eklemek: Gerekli. ManagingCustomerId veya ManagingCustomerNumber gereklidir, ancak her ikisinin belirtilmesi işlemin başarısız olmasına neden olur.
Güncelleştirmek: Salt okunur ve Gerekli		 dizgi
Ad Bu istemci bağlantısına başvurmak için kullanılabilecek kolay ad.

Ad en fazla 40 karakter içerebilir.

Belirtilmezse varsayılan bir ad sağlanır. Adın, kullanıcının diğer istemci bağlantılarına kıyasla benzersiz olması gerekmez.

Eklemek: Opsiyonel
Güncelleştirmek: Salt okunur		 dizgi
Not İstek sahibinden gelen ve istemci bağlantısı daveti hakkında bağlam ve ayrıntılar sağlayan isteğe bağlı ileti.

Eklemek: Opsiyonel
Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.		 dizgi
BaşlangıçTarihi Durumun güncelleştirileceği tarih. Kabul edilen bir bağlantı isteği için durum bu tarihte Etkin'e, bağlantı kaldırma isteği için ise durum bu tarihte Etkin Değil'e geçiş yapar.

Belirtilmezse, bu değer geçerli tarih ve saate ayarlanır.

Eklemek: Opsiyonel
Güncelleştirmek: Salt okunur		 dateTime
Durum İstemci bağlantısının yaşam döngüsü durumunu belirler, örneğin istemci bağlantısının kabul edilip edilmediğini veya reddedildiğini belirler.

İstemci bağlantısı eklerken bu öğe belirtilemez ve hizmet etkin durumu LinkPending olarak ayarlar.

Eklemek: Salt okunur
Güncelleştirmek: Gerekli		 ClientLinkStatus
SuppressNotification İstemci bağlantı davetinin e-posta bildiriminin, istemci reklamveren hesabının birincil kullanıcısına gönderilip gönderilmeyeceğini belirler.

true olarak ayarlanırsa istemci bir e-posta almaz ve aksi takdirde varsayılan değer false olduğundan istemci bir e-posta bildirimi alır.

Eklemek: Opsiyonel
Güncelleştirmek: Salt okunur		 Boolean
Zaman damgası Gelecekte kullanılmak üzere ayrılmıştır. base64Binary
Tür Bağlantının bir müşteri reklamveren hesabına mı yoksa müşteri müşterisine mi olduğunu belirler.

Olası değerler AccountLink ve CustomerLink'tir. Bu öğe boşsa veya AccountLink olarak ayarlanmışsa ClientEntityId, ClientEntityName ve ClientEntityNumber bir istemci reklamveren hesabını temsil eden bir hesaptır. Bu öğe CustomerLink olarak ayarlanırsa ClientEntityId, ClientEntityName ve ClientEntityNumber bir istemci müşterisini temsil edecektir.

Eklemek: Opsiyonel. Bu öğe ayarlanmadıysa, hizmet bir reklamveren hesabı istemci bağlantısı oluşturmayı dener.
Güncelleştirmek: Salt okunur		 dizgi

Gereksinimler

Hizmet: CustomerManagementService.svc v13
Ad alanı: https://bingads.microsoft.com/Customer/v13/Entities

Kullanan

AddClientLinks
SearchClientLinks
UpdateClientLinks