Bu rehberde: Pinterest işletme hesabınızı bağlarsınız. Pin oluşturmak için görsel, hedef bağlantı ve pano zorunludur. Trial ve Standard erişim farkını öğrenirsiniz.
⏱ 15 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | PINTEREST |
| Kategori | Sosyal medya |
| Kimlik doğrulama | İzin ekranı (OAuth 2.0) |
| Kapsam | Proje bazlı |
| Webhook | Hayır |
| Yetenekler | Gönderi yayınlama, metrik okuma |
| Kullanan kutular | Yayınla, Zamanla, Metrik al |
| Kullanan ajanlar | Content Creator, Social Publisher |
Ne işe yarar?
Panolarınıza görsel veya video pin oluşturur (başlık, açıklama, hedef bağlantı); pin ve hesap analitiğini okur.
Ön koşullar
- Pinterest Business hesabı (Ayarlar → Hesap yönetimi → İşletme hesabına dönüştür).
- developers.pinterest.com geliştirici hesabı.
- Platform yöneticisinin
PINTEREST_APP_IDvePINTEREST_APP_SECRETtanımlamış olması. - En az bir pano.
Adım adım kurulum
A) Pinterest Developers (platform yöneticisi)
- ① My apps → Connect app → uygulama adı, şirket bilgisi, uygulama adresi.
- ② Kullanım amacı: "içerik zamanlama ve analitik".
- ③ Submit. Onay sonrası uygulama Trial access ile açılır.
- ① Redirect URIs:
https://api.orqlabs.com/api/v1/integrations/oauth/pinterest/callback. ② Save.
- ① App ID ve ② App secret key değerlerini yöneticiye iletin;
PINTEREST_APP_IDvePINTEREST_APP_SECRETolarak tanımlanır.
- Canlı kullanım için ② Request standard access: kullanım senaryosu, ekran kaydı ve gizlilik politikası ile başvurun.
B) OrqLabs'ta bağlama
- Entegrasyonlar → Pinterest → Bağla.
- ① Proje seçin; ② Bağla.
- Pinterest yetkilendirme ekranında işletme hesabınızla giriş yapın; Give access.
- Kart Bağlı olur. Bağlantıyı test et: kullanıcı adı ve pano sayısı görünür.
- Bağlantı sırasında hesabın ilk panosu varsayılan olur. Değiştirmek için Pinterest kartını açın → Pin panosu bölümünde panoyu listeden seçin (liste hesabınızdan canlı okunur; Listeyi yenile yeni panoları getirir) → Kaydet. Tek bir iş akışında başka panoya pin atmak için Gönderi yayınla kutusunun Pano kimliği (Pinterest) alanını doldurun.
İzinler ve kapsamlar
| Kapsam | Neden gerekli |
|---|---|
boards:read | Panoları listeleme |
pins:read | Pin listesi ve analitik |
pins:write | Pin oluşturma, düzenleme, silme |
user_accounts:read | Hesap bilgisi ve analitiği |
Erişim seviyeleri
- Trial access: geliştirme ve kendi hesabınız için yeterli; günlük ~1.000 çağrı; yalnızca uygulama sahibiyle ilişkili hesaplar.
- Standard access: başka işletmelerin hesapları ve yüksek kota için zorunlu; inceleme birkaç gün–birkaç hafta.
- Aynı görselin çok panoya kısa sürede eklenmesi hesabı kısıtlayabilir.
Limitler
| Konu | Sınır |
|---|---|
| Hız sınırı | Kullanıcı başına dakikada 1.000 (Standard); Trial günlük ~1.000 |
| Pin gereksinimleri | Görsel zorunlu, hedef bağlantı zorunlu, pano zorunlu |
| Başlık | 100 karakter |
| Açıklama | 500 karakter; hashtag 5 |
| Görsel | JPEG/PNG, 20 MB, önerilen 2:3 |
| Video | MP4/MOV, 4 sn – 15 dk, 2 GB; kapak görseli zorunlu |
| İzin | Erişim 30 gün; yenileme 365 gün (otomatik) |
| Analitik | 24-48 saat gecikmeli |
Yayınla kutusunda eşleme: metin → açıklama, Title → pin başlığı, Link → hedef adres, ilk medya → görsel/video.
Bağlantıyı test etme
② Bağlantıyı test et hesap bilgisini ve panoları okur. Test modunda Yayınla kutusu başlık/açıklama uzunluğunu ve görsel/bağlantı varlığını doğrular.
Kimlik bilgilerini yenileme
- 30 günlük erişim otomatik yenilenir. Yenileme izni 365 gün sonra veya kullanıcı erişimi kaldırdığında (Ayarlar → Güvenlik → Bağlı uygulamalar) düşer → Yeniden yetkilendir.
- App secret yenilenirse yönetici
.env'i günceller; mevcut izinler düşer.
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
| "Invalid redirect_uri" | Adres kayıtlı değil | Redirect URIs listesine ekleyin |
| "This app is in trial mode" / 403 | Standard access yok | Başvurun; test hesabı ekleyin |
AUTH – 401 | İzin dolmuş | Yeniden yetkilendir |
INVALID – "board_id required" / "media_source required" | Pano veya görsel eksik | Kartta Pin panosu seçin; görsel adresini ekleyin |
INVALID – "link is invalid" | Hedef adres boş | Link alanını doldurun |
INVALID – "title too long" | Başlık > 100 | Content Creator'a sınır belirtin |
RATE_LIMIT – 429 | Kota | Pin sıklığını düşürün |
| Hesap kısıtlandı | Kısa sürede çok pin | Günde 5-10 pin, farklı görseller |
Sık sorulan sorular
Kişisel hesabımı bağlayabilir miyim? Hayır. İşletme hesabı gerekir; dönüştürme ücretsizdir.
Pin'e bağlantı eklemek zorunlu mu? Evet. Pinterest API'si hedef bağlantı ister; Content Creator'a site adresini vermesini söyleyin.
Hangi panoya gider? Pinterest kartında seçili Pin panosuna. Gönderi yayınla kutusunda Pano kimliği doluysa o panoya.