Sosyal Akış Anahtarları: Instagram Jetonu, YouTube, Google Yorumları

Nerede bulunur: Sol menü → Entegrasyonlar → Sosyal Medya bölümü (Instagram Akışı · YouTube Akışı · Google Yorumları) Kimler için: Tema editöründeki sosyal akış bloklarını gerçek içerikle çalıştırmak isteyen, ama "jeton", "API anahtarı", "Place ID" gibi kavramlarla ilk kez karşılaşanlar Kısaca: Üç kaynaktan yalnız YouTube anahtarsız çalışır; Instagram için bir erişim jetonu, Google Yorumları için bir API anahtarı üretmeniz gerekir. Bu belge her birini ekran ekran anlatır. Blokların kendisi için Sosyal Akış Blokları: Instagram, YouTube, Google Yorumları sayfasına bakın.

---

Önce bilinmesi gerekenler

Neden jeton gerekiyor? Instagram ve Google, hesabınızın verisini yalnız "sizin adınıza sorulduğunda" verir. Jeton ya da anahtar, "bu isteği ben yaptım" demenin dijital yoludur. Treyza bu anahtarları şifreli saklar, vitrine hiçbir zaman göndermez ve içeriği kendi sunucusunda 30 dakika önbellekler; ziyaretçinin tarayıcısı Instagram'a, YouTube'a ya da Google'a gitmez.

Jetonsuz yol var mı? Aşağıdaki tablo hangi kaynağın ne istediğini özetler.

---

YouTube

Anahtarsız kurulum (önerilen)

1. Kanalınızın kimliğini bulun. Üç yoldan biri yeter:
   • @tanıtıcı: Kanal sayfanızın adresi youtube.com/@magazam ise @magazam yazın. En kolayı budur.
   • Kanal ID: YouTube Studio → Ayarlar → Kanal → Gelişmiş ayarlar altındaki UC ile başlayan 24 karakterlik kimlik.
   • Oynatma listesi ID: Yalnız belirli bir listeyi göstermek için listeyi açın, adres çubuğundaki list= değerini (PL… ile başlar) kopyalayın.
2. Entegrasyonlar → Sosyal Medya → YouTube Akışı'nı açın; Kanal ID veya @tanıtıcı alanına (ya da Oynatma Listesi ID alanına) yapıştırın. API anahtarı alanını boş bırakın.
3. Bağlantı Test Et → "… (RSS, anahtarsız)" mesajını görün, entegrasyonu etkinleştirin.

Anahtarsız yolda Treyza YouTube'un herkese açık RSS akışını okur: en fazla 15 video, kapak görseli, başlık ve tarih gelir. Blokta en çok 12 video gösterildiği için bu sınır pratikte fark edilmez.

İsteğe bağlı: API anahtarı ne zaman gerekir?

Yalnız şu durumlarda: kanalınızda 15'ten eski videoları listelemek istiyorsanız (RSS yalnız son 15'i verir) ya da Google'ın kanal başlığı/özel adresi gibi ek bilgilerini kullanmak istiyorsanız. Anahtar üretmek için:

1. console.cloud.google.com → yeni proje (ör. "Magaza Vitrin").
2. API'ler ve Hizmetler → Kitaplık → "YouTube Data API v3" → Etkinleştir.
3. Kimlik bilgileri → Kimlik bilgisi oluştur → API anahtarı. Anahtarı kopyalayın.
4. Anahtarın yanındaki Kısıtla: API kısıtlamaları → yalnız "YouTube Data API v3". Uygulama kısıtlaması gerekmez (istekler Treyza sunucusundan gider).
5. Anahtarı YouTube Data API v3 Anahtarı alanına yapıştırın; kanal/list alanları aynı kalır.

Kota: günlük 10.000 birim; Treyza kanal + liste sorgusu için 2 birim harcar ve sonucu 30 dakika önbellekler.

---

Instagram

Ön koşullar

• Instagram hesabınız profesyonel (İşletme ya da İçerik Üretici) olmalı. Instagram uygulamasında Ayarlar → Hesap türü ve araçlar → Profesyonel hesaba geç ile ücretsiz dönüştürülür. Kişisel hesaplar Graph API'ye erişemez.
• Bir Meta geliştirici hesabı (Facebook hesabınızla açılır, ücretsiz). Facebook Sayfası bağlamak gerekmez; "Instagram ile giriş" yöntemi kullanılır.

Adım adım: uzun ömürlü jeton üretme

1. developers.facebook.com/apps → Uygulama oluştur.
   • Kullanım durumu sorulduğunda "Diğer" → uygulama türü "İşletme" (Business) seçin. Ad olarak mağaza adınızı yazın.
2. Uygulama panosunda Ürün ekle → Instagram → Kur (Set up).
3. Sol menüden Instagram → API setup with Instagram login sayfasını açın.
4. 1. adım – Instagram hesabı ekle: "Add account" ile Instagram hesabınıza giriş yapın ve izinleri onaylayın. Hesap listeye eklenince yanında Instagram kullanıcı kimliği (yalnız rakamlardan oluşan uzun sayı, ör. 17841400123456789) görünür. Bu kimliği not edin.
5. 2. adım – Jeton üret: Hesabın satırındaki Generate token düğmesine basın; açılan pencerede tekrar giriş yapıp izinleri onaylayın. Ekrana gelen uzun metin (IGAA… ile başlar) sizin uzun ömürlü erişim jetonunuzdur; "I understand" kutusunu işaretleyip kopyalayın.
   • Bu jeton 60 gün geçerlidir. Treyza 30 günü geçince jetonu otomatik yeniler; hiçbir şey yapmanız gerekmez.
6. Treyza'da Entegrasyonlar → Sosyal Medya → Instagram Akışı:
   • Uzun Ömürlü Erişim Jetonu alanına kopyaladığınız jetonu,
   • Instagram Kullanıcı ID alanına 4. adımdaki rakamları yapıştırın,
   • isterseniz Profil Bağlantısı alanına https://www.instagram.com/kullaniciadi yazın (boşsa kullanıcı adınızdan üretilir).
7. Bağlantı Test Et → @kullaniciadi görünmeli. Ardından etkinleştirin.

ℹUygulama "geliştirme modunda" kalabilir. Yalnız kendi hesabınızın verisini kendi mağazanızda gösterdiğiniz için Meta'nın uygulama incelemesine (App Review) girmenize gerek yoktur; geliştirme modu bu kullanım için yeterlidir.

• Jeton yerine "App ID" ya da "App Secret" yapıştırmak. Jeton IGAA… ile başlayan çok uzun bir metindir.
• Kullanıcı kimliği yerine kullanıcı adını yazmak. Alan yalnız rakam kabul eder.
• Kişisel (profesyonel olmayan) hesapla jeton üretmeye çalışmak: "Add account" adımı hata verir.
• Instagram şifrenizi değiştirmek ya da uygulamayı silmek jetonu geçersiz kılar. Blok son başarılı içeriği 24 saat daha gösterir, sonra kaybolur; yeni jeton üretip aynı alana yapıştırmanız yeterlidir.

Jeton ne zaman yenilenir, ben ne yapmalıyım?

Hiçbir şey. Treyza, kaydettiğiniz jetonu ilk 24 saat geçtikten ve 30 gün dolduktan sonra Instagram'ın yenileme ucuyla kendisi tazeler; yeni jeton yine şifreli saklanır. Yenileme başarısız olursa (uygulama silinmiş, hesap kapatılmış) blok ayarlarındaki Bağlantı durumu satırı sarıya döner ve sizi bu sayfaya yönlendirir.

---

Google Yorumları

Adım adım: API anahtarı

1. console.cloud.google.com → proje seçin ya da yeni proje açın. (Aynı projeyi YouTube için de kullanabilirsiniz.)
2. Faturalandırma hesabı bağlı değilse Faturalandırma bölümünden bağlayın. Places API için bu zorunludur; Google her ay ücretsiz kredi tanır ve bir mağazanın 30 dakikada bir yaptığı sorgu bu kredinin çok altında kalır.
3. API'ler ve Hizmetler → Kitaplık → "Places API (New)" → Etkinleştir. (Adında "(New)" olmayan eski Places API'yi değil, yenisini seçin.)
4. Kimlik bilgileri → Kimlik bilgisi oluştur → API anahtarı → kopyalayın.
5. Kısıtla: API kısıtlamaları → yalnız "Places API (New)". Uygulama kısıtlaması eklemeyin (istek Treyza sunucusundan gider, tarayıcıdan değil).

Adım adım: Place ID

1. Place ID bulucu sayfasını açın.
2. Haritanın üstündeki arama kutusuna işletmenizin Google Haritalar'daki adını yazın ve listeden seçin.
3. Açılan balondaki Place ID (ChIJ… ile başlar) değerini kopyalayın.

Treyza'ya girme

Entegrasyonlar → Sosyal Medya → Google Yorumları: API anahtarı, Place ID ve Yorum Dili (Türkçe / İngilizce — Google yorumları o dile çevirir). Bağlantı Test Et işletme adını göstermeli; sonra etkinleştirin.

---

Sık sorulan

Anahtarları girdim, blok vitrinde hâlâ yok. Entegrasyon etkin mi? Kayıt tek başına yetmez; kartın üstündeki anahtar açık olmalı. Etkinleştirdikten sonra vitrin en geç 5 dakika içinde güncellenir.

Bir anahtarı birden fazla mağazada kullanabilir miyim? Evet; entegrasyonlar mağaza bazlıdır, aynı anahtarı her mağazaya ayrı ayrı girersiniz.

Anahtarımı kim görebilir? Yalnız siz, girdiğiniz an. Kaydedildikten sonra panelde maskeli (••••1234) gösterilir, şifreli saklanır ve vitrine hiçbir zaman gönderilmez.

YouTube'da 15'ten fazla video göstermek istiyorum. Blok en çok 12 video gösterir; bu yüzden RSS sınırı hissedilmez. Yine de daha derin liste gerekirse isteğe bağlı API anahtarını girin.