InsertOrder Veri Nesnesi - Müşteri Faturalaması

Ekleme siparişi, hesabınızda belirli bir süre boyunca harcayacağınız maksimum tutarı oluşturan bir sözleşmedir. Hesabınız için aylık fatura faturalaması ayarlandıysa, reklamlarınızın teslimat için uygun olması için etkin bir ekleme siparişinizin olması gerekir. Kampanya bütçenizi kullanarak harcamalarınızı denetlemeye devam edebilirsiniz ve yalnızca tahakkuk ettiğiniz ücret tahsil edilir. Örneğin, 5.000 ABD doları tutarında bir aylık ekleme siparişiniz varsa ve faturalama döneminde yalnızca 4.500 ABD doları ücret tahakkuk ettiyseniz, ekleme siparişi bütçenizden yalnızca 4.500 ABD doları düşülür.

Uyarı

Ekleme siparişi bütçesi yalnızca reklam harcamaları için geçerlidir. İşletmeniz çevrimiçi hizmetler vergilendiği bir ülkede/bölgedeyse önemli bir ayrımdır. Katı bir bütçe sınırınız varsa, ekleme siparişi bütçenizdeki vergileri hesaba katmalısınız. İşletme konumunuzdaki vergi gereksinimleri hakkında daha fazla bilgi edinmek için Vergi veya KDV bilgileri yardım makalesine bakın.

Bu nesnenin çoğu öğesi yalnızca ekleme sırası onaylanana kadar ayarlanabilir; örneğin Durum PendingUserReview olarak ayarlanmışsa. Bu durumda, bu nesnenin öğeleri aracılığıyla yeni değişiklikler yapabilir veya ekleme sırasını onaylayabilir veya reddedebilirsiniz. Ekleme sırası Durumu Etkin, Tükenmiş, Süresi Doldu veya Başlamadı olduğunda, PendingChanges öğesi aracılığıyla yeni değişiklikler yapabilir veya geçerli bekleyen değişiklikleri onaylayabilir veya reddedebilirsiniz. Ekleme sırası Durumu İptal Edildi veya Reddedildi ise, ekleme sırasını güncelleştiremezsiniz.

Not

SearchInsertionOrders işlemi, yinelenen seri başına en fazla 24 ekleme siparişi döndürür.

Bing Ads API'sini kullanarak çok az özel durumla bir ekleme siparişi serisi ekleyemez veya güncelleştiremezsiniz. Ekleme sırasının yinelenen bir seride olup olmadığını belirlemek için IsInSeries öğesini kullanın.

• Yinelenen bir serinin parçası olan bir ekleme siparişinin BaşlangıçTarihi veya BitişTarihi'ni güncelleştirmeye çalışırsanız API bir hata döndürür.
• Yinelenen serinin parçası olan bir ekleme siparişinin Durumunu güncelleştirirseniz, durum güncelleştirmesi serideki tüm ekleme siparişlerine uygulanır.

Microsoft Advertising web uygulamasında yinelenen ekleme siparişlerini yönetmek için ekleme siparişi oluşturma ve düzenleme Nasıl yaparım?? yardım makalesine bakın.

Sözdizimi

<xs:complexType name="InsertionOrder" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AccountId" type="xs:long" />
    <xs:element minOccurs="0" name="BookingCountryCode" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Comment" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="EndDate" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="LastModifiedByUserId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="LastModifiedTime" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="NotificationThreshold" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="ReferenceId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="SpendCapAmount" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="StartDate" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:InsertionOrderStatus" />
    <xs:element minOccurs="0" name="PurchaseOrder" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="PendingChanges" nillable="true" type="tns:InsertionOrderPendingChanges" />
    <xs:element minOccurs="0" name="AccountNumber" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="BudgetRemaining" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="BudgetSpent" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="BudgetRemainingPercent" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="BudgetSpentPercent" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="SeriesName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="IsInSeries" nillable="true" type="xs:boolean" />
    <xs:element minOccurs="0" name="SeriesFrequencyType" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="IsUnlimited" nillable="true" type="xs:boolean">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="IsEndless" nillable="true" type="xs:boolean">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
  </xs:sequence>
</xs:complexType>

Öğe

InsertOrder nesnesi şu öğelere sahiptir: AccountId, AccountNumber, BookingCountryCode, BudgetRemaining, BudgetRemainingPercent, BudgetSpent, BudgetSpentPercent, Comment, EndDate, Id, IsEndless, IsInSeries, IsUnlimited, LastModifiedByUserId, LastModifiedTime, Name, NotificationThreshold, PendingChanges, PurchaseOrder, ReferenceId, SeriesFrequencyType, SeriesName, SpendCapAmount, StartDate, Status.

Öğe	Açıklama	Veri Türü
AccountId	Ekleme siparişinin uygulandığı hesabın tanımlayıcısı. Ekleme sırasını oluşturduktan sonra hesap tanımlayıcısını güncelleştiremezsiniz. Ekle: Gerekli Güncelleştirme: Salt okunur	Uzun
AccountNumber	Microsoft Advertising web uygulamasında hesabı tanımlamak için kullanılan sistem tarafından oluşturulan hesap numarası. Hesap numarası xxxxxx biçimindedir. Burada xxxxxxxxx , sekiz alfasayısal karakterden oluşan bir seridir. Ekle: Salt okunur Güncelleştirme: Salt okunur	Dize
BookingCountryCode	dahili kullanım için ayrılmıştır. Ekle: Bazı hesaplar için gerekli; Bazı hesaplar için isteğe bağlı. Güncelleştirme: Salt okunur	Dize
BudgetRemaining	Ekleme sırasının çalışan bakiyesi. Çalışan bakiye değeri başlangıçta SpendCapAmount ile aynıdır ve hesaptaki bir reklam her sunulduğunda azalır. Ekleme siparişi sınırsız bütçeye sahipse bu öğe boş olur. Ekle: Salt okunur Güncelleştirme: Salt okunur	Çift
BudgetRemainingPercent	Ekleme siparişi için kalan bütçe yüzdesi. Bu değer BudgetRemaining / SpendCapAmount olarak hesaplanır. Ekleme siparişi sınırsız bütçeye sahipse bu öğe boş olur. Ekle: Salt okunur Güncelleştirme: Salt okunur	Çift
BütçeSpent	Ekleme sırasının kalan bakiyesi. Kalan bakiye başlangıçta 0 (sıfır) olur ve hesaptaki bir reklam her sunulduğunda SpendCapAmount'a doğru artar. Ekleme siparişi sınırsız bütçeye sahipse bu öğe boş olur. Ekle: Salt okunur Güncelleştirme: Salt okunur	Çift
BudgetSpentPercent	Ekleme siparişi için harcanan bütçe yüzdesi. Bu değer BudgetSpent / SpendCapAmount olarak hesaplanır. Ekleme siparişi sınırsız bütçeye sahipse bu öğe boş olur. Ekle: Salt okunur Güncelleştirme: Salt okunur	Çift
Açıklama ekleme	Ekleme sırasının açıklaması. Açıklama 100 karakterle sınırlıdır. Ekle: Isteğe bağlı Güncelleştirme: Isteğe bağlı	Dize
Bitiştarihi	Ekleme siparişinin süresinin dolmak üzere olduğu tarih. Bitiş tarihi başlangıç tarihinden sonra olmalıdır. Tarih Eşgüdümlü Evrensel Saat (UTC) içinde depolanır. Yalnızca belirtilen dizenin ay, gün ve yılı kullanılır. Bir tarihin saatini, dakikalarını ve saniyelerini belirtirseniz bunlar yoksayılır. Tarih ve saatin biçimi hakkında bilgi için temel XML Veri Türleri'ndekidateTime girdisine bakın. Not: Ekleme siparişinin bitiş tarihi yoksa EndDate boş olur. Sınırsız ekleme siparişi ekleme veya güncelleştirme desteklenmez. EndDate salt okunur modda çalışır. Ekle: Gerekli Güncelleştirme: Isteğe bağlı. Yinelenen bir serinin parçası olan bir ekleme siparişinin BaşlangıçTarihi veya BitişTarihi'ni güncelleştirmeye çalışırsanız API bir hata döndürür.	Datetime
Kimlik	Ekleme sırasını tanımlayan sistem tarafından oluşturulan bir tanımlayıcı. Ekle: Salt okunur Güncelleştirme: Salt okunur ve Gerekli	Uzun
IsEndless	Ekleme sırasının bitiş tarihi olup olmadığını belirler. Değer True ise, ekleme sırasının bitiş tarihi yoktur ve bu ekleme sırasının Bitiş Tarihi yoksayılır. Ekle: Isteğe bağlı Güncelleştirme: Isteğe bağlı	Boolean
IsInSeries	Ekleme sırasının yinelenen bir seride olup olmadığını belirler. Değer True ise, ekleme sırası yinelenen serinin bir parçasıdır. Yinelenen bir serinin parçası olan bir ekleme siparişinin BaşlangıçTarihi veya BitişTarihi'ni güncelleştirmeye çalışırsanız API bir hata döndürür. Yinelenen serinin parçası olan bir ekleme siparişinin Durumunu güncelleştirirseniz, durum güncelleştirmesi serideki tüm ekleme siparişlerine uygulanır. Ekle: Salt okunur Güncelleştirme: Salt okunur	Boolean
IsUnlimited	Ekleme siparişinin sınırsız bütçesi olup olmadığını belirler. Değer True ise, ekleme sırası sınırsız bütçeye sahip olur ve bu ekleme sırasının SpendCapAmount değeri yoksayılır. Ekle: Isteğe bağlı Güncelleştirme: Isteğe bağlı	Boolean
LastModifiedByUserId	Ekleme sırasını güncelleştiren son kullanıcının tanımlayıcısı. Ekle: Salt okunur Güncelleştirme: Salt okunur	Uzun
LastModifiedTime	Ekleme sırasının en son güncelleştirildiği tarih ve saat. Tarih Eşgüdümlü Evrensel Saat (UTC) içinde depolanır. Tarih ve saatin biçimi hakkında bilgi için temel XML Veri Türleri'ndekidateTime girdisine bakın. Ekle: Salt okunur Güncelleştirme: Salt okunur	Datetime
Adı	Bu ekleme sırasına başvurmak için kullanılabilecek kolay ad. Ad en fazla 100 karakter içerebilir. Adın, müşterinin diğer ekleme siparişleriyle karşılaştırıldığında benzersiz olması gerekmez. Ekle: Isteğe bağlı Güncelleştirme: Isteğe bağlı	Dize
NotificationThreshold	Harcanan bütçenin yüzdesi. Yüzdeyi 0'dan 100'e kadar olan bir değer olarak belirtin. Eşiğe ulaşıldığında bildirim gönderilir. Örneğin, eşiği 70 olarak ayarlarsanız, bütçenin yüzde 70'ini harcadığınızda Faturalama hizmeti bildirim gönderir. Bildirim almak istemiyorsanız NULL olarak ayarlayın. dahili kullanım için ayrılmıştır. Ekle: Isteğe bağlı Güncelleştirme: Isteğe bağlı	Çift
Pendingchanges	Durumu Etkin, Tükenmiş, Süresi Dolmuş veya Başlamamış olarak ayarlanmış onaylı bir ekleme siparişinin değişikliklerini yönetmek için kullanılabilir. Ekle: Salt okunur Güncelleştirme: Isteğe bağlı	InsertOrderPendingChanges
PurchaseOrder	Aylık faturalarda bu ekleme siparişine başvurmak için kullanılabilecek bir satınalma siparişi değeri. Bu değer, aylık faturalarda satınalma siparişi olarak yazdırılır. Satın alma siparişi en fazla 50 karakter içerebilir. Ekle: Isteğe bağlı Güncelleştirme: Isteğe bağlı	Dize
ReferenceId	Yalnızca iç kullanım için ayrılmıştır. Ekle: Isteğe bağlı Güncelleştirme: Isteğe bağlı	Uzun
SeriesFrequencyType	Bir siparişin seride nasıl yineleneceğini belirler. Olası değerler Aylık, BiMonthly, Üç Aylık ve Yıllık'tır. Ekle: Salt okunur Güncelleştirme: Salt okunur	Dize
SeriesName	Yinelenen ekleme sırası serisinin adı. Ad en fazla 100 karakter içerebilir. Ekleme sırası daha sonra yinelenen seriden kaldırılsa bile, bu öğe oluşturulduğu serinin adını yansıtmaya devam eder. Ekle: Salt okunur Güncelleştirme: Salt okunur	Dize
SpendCapAmount	Bu ekleme siparişinin bütçesi. Bütçe sabit bir sınırdır. Hesap bu sınıra ulaştığında ve başka bir ekleme siparişi olmadığında, hesabın yaşam döngüsü durum değeri Duraklat olarak ayarlanır. Ekleme siparişi sınırsız bütçeye sahipse bu öğe boş olur. Bütçe, bir ekleme siparişi için harcamak istediğiniz maksimum para miktarıdır. Sınırsız bütçeye sahip ekleme siparişleri için bütçeniz kredi limitinize bağlıdır. Bu durumda her kampanyanın günlük bütçesi maksimum harcamayı belirler. Not: Sınırsız ekleme siparişi ekleme veya güncelleştirme desteklenmez. SpendCapAmount salt okunur modda çalışır. Ekle: Gerekli Güncelleştirme: Isteğe bağlı	Çift
Startdate	Ekleme siparişinin ücretleri tahakkuk ettirebileceği tarih. Başlangıç tarihi geçerli tarihten sonra olmalıdır. Tarih Eşgüdümlü Evrensel Saat (UTC) içinde depolanır. Yalnızca belirtilen dizenin ay, gün ve yılı kullanılır. Bir tarihin saatini, dakikalarını ve saniyelerini belirtirseniz bunlar yoksayılır. Tarih ve saatin biçimi hakkında bilgi için temel XML Veri Türleri'ndekidateTime girdisine bakın. Ekle: Gerekli Güncelleştirme: Isteğe bağlı. Başlangıç tarihini yalnızca Durum PendingUserReview ise bu öğe aracılığıyla güncelleştirebilirsiniz. Başlangıç tarihi zaten geçtiyse, bunu değiştiremezsiniz. Yinelenen bir serinin parçası olan bir ekleme siparişinin BaşlangıçTarihi veya BitişTarihi'ni güncelleştirmeye çalışırsanız API bir hata döndürür.	Datetime
Durum	Ekleme sırasının durumu. Ekle: Salt okunur. Oluşturduğunuz ekleme siparişleri hemen Etkin, Başlamadı veya Reddedildi olarak ayarlanır. Güncelleştirme: Henüz onaylanmamış bir ekleme siparişini onaylamak veya reddetmek veya zaten onaylanmış bir ekleme siparişini iptal etmek için gereklidir. Bu öğe aracılığıyla yalnızca geçerli durum PendingUserReview olarak ayarlandıysa onaylayabilir veya reddedebilirsiniz. Bu öğe aracılığıyla yalnızca geçerli durum Etkin, Tükenmiş veya Başlamadı olarak ayarlandıysa iptal edebilirsiniz. Ekleme sırası durumu Etkin, Tükenmiş, Süresi Doldu veya Başlamadı olduğunda, PendingChanges öğesi aracılığıyla yeni değişiklikler yapabilir veya geçerli bekleyen değişiklikleri onaylayabilir veya reddedebilirsiniz. UpdateInsertionOrder'ı çağırdığınızda, bu Status öğesini ayarlayabilir veya bu nesnenin diğer öğelerini değiştirebilirsiniz, ancak durumu diğer özellik güncelleştirmeleriyle paralel olarak değiştiremezsiniz. Yinelenen serinin parçası olan bir ekleme siparişinin Durumunu güncelleştirirseniz, durum güncelleştirmesi serideki tüm ekleme siparişlerine uygulanır.	InsertOrderStatus

Gereksinimler

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

Kullanan

AddInsertionOrder
SearchInsertionOrders
UpdateInsertionOrder