Ana içeriğe geç
PDF4me APIEntegrasyonlarBilgi BankasıUzantılarAPI Test CihazıBlog

Resim Başlığı ve Alt Bilgisi Ekle - Excel API

PDF4me Resim Ekle Başlık Altbilgi Bu özellik, özelleştirilebilir resim başlıkları ve altbilgileri eklemenizi sağlar. Excel Kapsamlı konumlandırma ve biçimlendirme kontrolüne sahip belgeler. API hizmet süreçleri Excel Dosyalara resim başlıkları veya altbilgileri ekler ve yerleştirme kontrolü (başlık/altbilgi), yatay hizalama (sol, orta, sağ), çalışma sayfası hedefleme (belirli sayfalar veya tüm sayfalar) ve santimetre cinsinden sayfa kenar boşlukları gibi özellikler sunar. API alır Excel belge içeriği ve görüntü verileri aracılığıyla REST API aramalar, kullanarak Base64 Güvenli iletim için kodlama. Desteklenen özellikler: PNG, JPG, JPEGGIF ve diğer resim formatlarını destekleyen bu çözüm, kurumsal marka oluşturma, profesyonel raporlar ve belge otomasyonu iş akışları için idealdir.

İlgili Blog Yazıları
Bu özellik için henüz bir blog yazısı yok — yakında yayınlanacak.
Bu arada, her platforma yönelik eğitimler ve iş akışları için PDF4me bloguna göz atın.
Blogu ziyaret edin →

Kimliğinizi Doğrulama API Rica etmek​

Lütfen şunları ekleyin: API Kimlik doğrulaması için istekte belirtilen anahtarı girin. PDF4me REST API.

Get your api Key

Başlıca Özellikler​

  • Başlık veya Alt Bilgi YerleşimiGörselleri belge başlığına mı yoksa altbilgi bölümüne mi yerleştireceğinizi seçin.
  • Pozisyon KontrolüGörselleri başlık/altbilgi alanında sola, ortaya veya sağa hizalayın.
  • Çalışma Sayfası HedeflemeGörselleri adlarına veya indekslerine göre belirli çalışma sayfalarına veya tüm çalışma sayfalarına uygulayın.
  • Kenar Boşluğu ÖzelleştirmeSayfa üst, alt, sol ve sağ kenar boşluklarını santimetre cinsinden ayarlayın.
  • Görüntü Formatı Desteği: PNG, JPG, JPEGve GIF formatları

REST API Uç nokta​

O PDF4me REST API standart kullanır HTTP Kaynaklarla etkileşim kurma yöntemleri. Tüm resim başlığı/altbilgi işlemleri için. Excel Tek bir uç nokta üzerinden gerçekleştirilirler:

  • Yöntem: POST
  • Uç nokta: office/ApiV2Excel/ExcelAddImageHeaderFooter

REST API Parametreler​

Önemli: Yıldız (*) ile işaretlenmiş parametreler zorunludur. Tüm istekler bu parametreleri kullanır. belge, belge içeriği, resim içeriği (kök seviyesi) ve addImageHeaderFooterToExcelActionDiğer seçenekler, eylem nesnesinin özellikleridir.

Gerekli Parametreler (kök düzey)​

ParametreTipTanımÖrnek
belge*ObjectBelge referansı. İçermelidir. İsim (sicim): Excel .xlsx veya .xls uzantılı dosya adı{ "Name": "data.xlsx" }
belge içeriği*String (Base64)Excel belge içeriği kodlanmıştır Base64UEsDBBQABgAIAAAA...
resim içeriği*String (Base64)Görüntü dosyasının içeriği şu şekilde kodlanmıştır: Base64Destekler PNG, JPG, JPEGGIF formatlarıiVBORw0KGgoAAAANS...
addImageHeaderFooterToExcelAction*ObjectEylem yapılandırması (konum, çalışma sayfası hedefleme, kenar boşlukları vb.)Aşağıda yük örneğini inceleyin.

İsteğe Bağlı Parametreler (addImageHeaderFooterToExcelAction içinde)​

ParametreTipTanımÖrnek
BaşlıkBooleanYerleştirme seçimi. true = Belge başlığına resim ekle (varsayılan), false = Belge altbilgisine resim ekletrue
konumStringBaşlık/altbilgi içinde yatay hizalama. Sol, Merkez, veya SağVarsayılan: "Ortala". Büyük/küçük harf duyarlılığı yok.Center
çalışma sayfası adlarıArray (sicim[])Görüntünün uygulanacağı çalışma sayfası adlarının dizisi. Hem worksheetNames hem de worksheetIndexes boşsa, tüm çalışma sayfalarına uygulanır.["Sheet1", "Report"]
çalışma sayfasıDizinlerArray (int[])Çalışma sayfası indekslerinin dizisi (1 tabanlı). Hem worksheetNames hem de worksheetIndexes boşsa, tüm çalışma sayfalarına uygulanır.[1, 2]
üstMarjSayı (çift)Sayfa üst kenar boşluğu santimetre cinsinden. Varsayılan: 1,91.9
alt kenar boşluğuSayı (çift)Sayfanın alt kenar boşluğu santimetre cinsinden. Varsayılan: 1,91.9
sol kenar boşluğuSayı (çift)Sol sayfa kenar boşluğu santimetre cinsinden. Varsayılan: 1,91.9
sağ kenar boşluğuSayı (çift)Sayfa sağ kenar boşluğu (santimetre cinsinden). Varsayılan: 1,91.9
kültürAdıStringBelge işlemeye yönelik kültür kodu (ör. "en-US", "de-DE", "fr-FR")en-US

Not: Eğer her ikisi de çalışma sayfası adları Ve çalışma sayfasıDizinler Eğer değerler boş veya geçersiz ise, resim tüm çalışma sayfalarına uygulanacaktır. Excel dosya.

Çıktı​

O PDF4me Resim Ekle Başlık Altbilgi REST API geri döner Excel belge olarak Base64-kodlanmış dize içinde JSON formatİkili veri olarak değil.

Senkron İşleme (Varsayılan)

O API İsteği işler ve geri döner:

Durum Kodu: 200 OK

Content-Type: application/json

Yanıt Metni:

{
"document": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"fileName": "data.xlsx",
"success": true,
"errorMessage": null
}

Yanıt Alanları:

  • belge (dize): The Excel Resim başlığı/altbilgisi eklenmiş belge, şu şekilde kodlanmıştır: Base64 sicim
  • dosya adı (dize): Çıktı Excel dosya adı
  • başarı (mantıksal değer): İsteğin başarılı olup olmadığını gösterir.
  • hataMesajı (dize veya boş): Başarı başarısız olduğunda hata ayrıntıları

Kullanım Talimatları:

  1. Çıkarın document tarladan JSON cevap (Base64)
  2. Şifreyi çöz Base64 ikili veriyi elde etmek için kullanılan dize Excel belge verileri
  3. Kaydet veya işle Excel Dosyayı gerektiği gibi düzenleyin.

Örnek (JavaScript):

const response = await fetch(url, options);
const data = await response.json();
const excelBytes = atob(data.document); // Decode Base64
// Save or process excelBytes

Talep Örneği​

Başlık​

Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY

Not:

  • Alın API anahtardan PDF4me Kontrol Paneli
  • O API anahtar olmalı Base64 "Basic" önekiyle kodlanmış ve ön eklenmiş Authorization başlık
  • Örnek: Eğer sizin API anahtar şudur abc123onu kodla Base64 ve kullanın Authorization: Basic YWJjMTIz

Yük​

Temel Örnek (Sadece Gerekli Alanlar):

{
 "document": { "Name": "data.xlsx" },
 "docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
 "imageContent": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
 "addImageHeaderFooterToExcelAction": {}
}

Gelişmiş Örnek (Tüm İsteğe Bağlı Alanlarla):

{
 "document": { "Name": "data.xlsx" },
 "docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
 "imageContent": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
 "addImageHeaderFooterToExcelAction": {
 "isHeader": true,
 "position": "Center",
 "worksheetNames": ["Sheet1", "Report"],
 "worksheetIndexes": [1, 2],
 "topMargin": 1.9,
 "bottomMargin": 1.9,
 "leftMargin": 1.9,
 "rightMargin": 1.9,
 "cultureName": "en-US"
 }
}

Kod Örnekleri​

O PDF4me Resim Başlığı ve Altbilgisi Ekle Excel REST API Birden fazla programlama dilinde kod örnekleri sunar. Geliştirme ortamınıza en uygun dili seçin:

C# (CSharp) Örnek

Tamamlamak C# Resim başlıkları/altbilgileri eklemek için uygulama Excel Belgeler:

Sektör Kullanım Örnekleri ve Uygulamaları​

Finans ve Muhasebe Kullanım Örnekleri

  • Finansal TablolarÇeyreklik raporlara şirket logosu başlıkları ekleyin.
  • Bütçe RaporlarıBütçe çalışma sayfalarına departman logolarını ekleyin.
  • Denetim BelgeleriAltbilgilere denetim firması logosu filigranı ekleyin.
  • Gider RaporlarıMasraf bildirimlerine şirket logosu başlıkları ekleyin.

Yardım Alın​

Get Your API KeyAPI SamplesGetting Started