Membina Automasi Media Sosial: Perkongsian LinkedIn dengan Fungsi Tanpa Pelayan

Selepas menerbitkan artikel atau catatan blog baharu, keperluan untuk mempromosikannya di media sosial timbul. Berkongsi siaran secara manual boleh memakan masa dan tidak cekap. Dalam artikel ini, kami akan meneroka cara membina fungsi tanpa pelayan untuk berkongsi URL artikel di LinkedIn menggunakan klien API JavaScript dan fungsi tanpa pelayan Netlify. Ini adalah sebahagian daripada membina aliran kerja automatik untuk promosi media sosial.

Jadual Kandungan

• Jadual Kandungan
• Prasyarat
• Bermula
  • Menyediakan kebenaran
  • Mengkonfigurasi tetapan OAuth 2.0
• Berkongsi siaran dengan URL menggunakan Klien JS API LinkedIn
  • Mendapatkan id unik pengguna
  • Berkongsi URL siaran
• Mendedahkan sebagai fungsi tanpa pelayan Netlify
• Menguji Kefungsian
• Menggunakan Netlify
• Ringkasan

Prasyarat

Untuk mengikuti tutorial ini, anda memerlukan yang berikut:

• Akaun LinkedIn
• Node.js dan Netlify CLI dipasang.
• Akaun Netlify dan tapak yang dicipta untuk menggunakan fungsi tanpa pelayan.
• Pengetahuan asas JavaScript dan TypeScript.

Bermula

Untuk mula bekerja dengan API LinkedIn, kami perlu melakukan langkah berikut:

1. Pergi ke Konsol Pembangun LinkedIn dengan akaun LinkedIn anda.
2. Buat apl baharu dengan mengklik pada butang Cipta Apl.
3. Isi butiran seperti Nama Apl (Penguji Media Sosial, contohnya) dan imej logo Apl.
4. Anda perlu ke halaman Syarikat LinkedIn untuk mengaitkan dengan apl yang anda cipta (mana-mana halaman yang anda ada akses pentadbir untuk dapat mengesahkan sambungan selepas itu).

Setelah selesai, portal akan mengubah hala anda ke papan pemuka apl, di mana kami boleh mula mengkonfigurasi kebenaran dan produk API yang kami perlukan untuk apl itu.

Menyediakan kebenaran

Dalam papan pemuka apl, klik pada tab Produk dan minta akses kepada Kongsi di LinkedIn dan Log Masuk dengan LinkedIn menggunakan produk OpenID Connect.

Mengkonfigurasi tetapan OAuth 2.0

Dengan kebenaran ini diberikan, kami boleh menuju ke alat penjana token OAuth 2.0 untuk menjana token akses bagi apl tersebut. Token itu hendaklah termasuk skop berikut: w_member_social untuk menyiarkan bagi pihak pengguna, dan profil serta dibuka untuk pengesahan pengguna dan maklumat profil.

Token akses ini ialah token OAuth berkaki 3, memastikan bahawa pengguna telah memberi kebenaran secara jelas kepada aplikasi untuk bertindak bagi pihak mereka. Selepas menjana token, kami boleh menggunakannya untuk mengesahkan dan membuat permintaan dengan selamat kepada API LinkedIn. Selain itu, kami boleh menyemak kebenaran dan skop yang diberikan kepada apl dalam tab Auth pada papan pemuka apl.

Hebat! Kini setelah kami mempunyai token akses dan apl disediakan, kami boleh mula membina automasi untuk menyiarkan di LinkedIn bagi pihak pengguna (yang, dalam kes ini, adalah kami).

Berkongsi siaran dengan URL menggunakan Klien JS API LinkedIn

Untuk mula berkongsi siaran secara pemrograman, kami boleh menggunakan Pelanggan JavaScript API LinkedIn rasmi untuk Node.js dengan memasangnya sebagai kebergantungan projek:

npm install linkedin-api-js-client

# or with yarn
yarn add linkedin-api-js-client

Pustaka ini menyediakan cara yang mudah dan ringan untuk berinteraksi dengan titik akhir API LinkedIn, memanfaatkan Axios dan TypeScript di bawah hud.

Seterusnya, mari buat fail baharu, linkedin.ts, untuk merangkum logik perkongsian siaran di LinkedIn. Kami mulakan dengan memulakan contoh klien untuk berinteraksi dengan API, seperti yang ditunjukkan di bawah:

// linkedin.ts
import { RestliClient } from 'linkedin-api-js-client';

const client = new RestliClient();

Mendapatkan id unik pengguna

Untuk menyiarkan bagi pihak pengguna, kami perlu mendapatkan semula ID unik pengguna (yang berbeza daripada pemegang LinkedIn pengguna). Ini boleh dilakukan dengan menggunakan titik akhir /userinfo dengan token akses yang dijana sebelum ini:

// linkedin.ts
const getUserId = async (accessToken: string) => {
  const userResponse = await client.get({
    resourcePath: "/userinfo",
    accessToken
  });

  return userResponse.data?.sub;
};

ID unik terletak dalam sub medan data respons. Nilai ini diperlukan untuk langkah seterusnya: berkongsi siaran bagi pihak pengguna.

Berkongsi URL siaran

Dalam linkedin.ts, kami mentakrifkan fungsi untuk berkongsi URL siaran seperti berikut:

type SharePostArgs = {
  url: string;
  text: string;
};

export const sharePost = async (token: string, content: SharePostArgs) => {
  //logic
};

Fungsi sharePost mengambil token akses dan kandungan untuk dikongsi, yang termasuk URL dan teks untuk mengiringi siaran. Kami kemudiannya akan mencipta entiti siaran baharu pada sumber Kandungan Dihasilkan Pengguna menggunakan titik akhir /ugcPosts, seperti ditunjukkan di bawah:

export const sharePost = async (token: string, content: SharePostArgs) => {
  const response = await client.create({
    resourcePath: '/ugcPosts',
    accessToken: token,
    entity: {
      //entity payload
    }
  });
};

Muatan entiti dikonfigurasikan untuk memasukkan ID unik pengguna, yang diambil lebih awal, sebagai pengarang. Medan pengarang mengikut format urn:li:person:${userId}. Selain itu, kami menyatakan:

• Status kitaran hayat sebagai "DITERBITKAN".
• Keterlihatan sebagai "AWAM" supaya siaran kelihatan kepada rangkaian LinkedIn.

Berikut ialah pelaksanaan yang dikemas kini:

npm install linkedin-api-js-client

# or with yarn
yarn add linkedin-api-js-client

Seterusnya, kami mentakrifkan kandungan perkongsian dalam medan Kandungan khusus objek entiti. Untuk senario ini, medan specificContent termasuk objek com.linkedin.ugc.ShareContent, yang mempunyai sifat berikut:

• shareCommentary: Menerima content.text sebagai kandungan teks utama untuk dipaparkan.
• shareMediaCategory: Menentukan jenis media yang dikongsi dalam siaran (ditetapkan sebagai "ARTIKEL").
• media: Susunan aset media untuk kategori "ARTICLE", di mana setiap item termasuk: URL untuk dikongsi dan status SEDIA.

Di bawah ialah kod yang dikemas kini:

// linkedin.ts
import { RestliClient } from 'linkedin-api-js-client';

const client = new RestliClient();

Setelah berjaya melengkapkan permintaan, respons mengandungi CreateEntityId, yang mewakili ID unik entiti yang dibuat. Kita boleh mengembalikan nilai ini kepada pemanggil untuk rujukan selanjutnya:

// linkedin.ts
const getUserId = async (accessToken: string) => {
  const userResponse = await client.get({
    resourcePath: "/userinfo",
    accessToken
  });

  return userResponse.data?.sub;
};

Dan itu sahaja! Kami telah mencipta fungsi yang memanfaatkan API LinkedIn untuk berkongsi URL siaran bagi pihak pengguna. Dalam langkah seterusnya, kami akan mendedahkan fungsi ini sebagai titik akhir tanpa pelayan menggunakan Netlify, membawa kami lebih dekat untuk mengautomasikan sepenuhnya proses perkongsian artikel di media sosial.

Mendedahkan sebagai fungsi tanpa pelayan Netlify

Kami menjalankan perintah CLI netlify functions:create and follow the prompts to scaffold fungsi Netlify serverless baru bernama share-on-linkedin. Netlify CLI akan menjana fungsi dalam direktori fungsi dengan kod awal berikut:

type SharePostArgs = {
  url: string;
  text: string;
};

export const sharePost = async (token: string, content: SharePostArgs) => {
  //logic
};

Dalam kod di atas ini, kami menggunakan TypeScript dan mentakrifkan fungsi sebagai async untuk mengendalikan sifat tak segerak panggilan API LinkedIn.

Seterusnya, kami mengemas kini fungsi tanpa pelayan untuk melakukan tindakan berikut:

• Menghuraikan kandungan permintaan untuk mengekstrak kandungan untuk dikongsi,
• Dapatkan semula token akses daripada pembolehubah persekitaran (boleh ditetapkan dalam fail .env dalam akar projek),
• Panggil fungsi sharePost (ditakrifkan sebelum ini dalam linkedin.ts ) dengan parameter yang diekstrak dan
• Kembalikan ID entiti yang dibuat sebagai respons.

export const sharePost = async (token: string, content: SharePostArgs) => {
  const response = await client.create({
    resourcePath: '/ugcPosts',
    accessToken: token,
    entity: {
      //entity payload
    }
  });
};

Pada ketika ini, fungsi tanpa pelayan sudah sedia. Kami boleh menggunakan ia ke Netlify dan menguji kefungsiannya dengan membuat permintaan POST ke titik akhir.

Menguji Kefungsian

Untuk menguji fungsi tanpa pelayan, mulakan pelayan setempat menggunakan perintah CLI netlify dev. Kemudian, gunakan alat seperti Posmen atau Insomnia untuk menghantar permintaan POST ke titik akhir pelayan dengan muatan JSON berikut:

export const sharePost = async (token: string, content: SharePostArgs) => {
  //Get user's unique id
  const userId = await getUserId(token);

  const response = await client.create({
    resourcePath: '/ugcPosts',
    accessToken: token,
    entity: {
      author: `urn:li:person:${userId}`,
      lifecycleState: "PUBLISHED",      
      visibility: {
        "com.linkedin.ugc.MemberNetworkVisibility": "PUBLIC"
      }
    }
  });
};

Sebagai alternatif, kami boleh mencipta UI bentuk ringkas untuk berinteraksi dengan API fungsi tanpa pelayan dan mengesahkan bahawa siaran itu berjaya dikongsi di LinkedIn.

Setelah fungsi berfungsi seperti yang diharapkan, mari kita teruskan menggunakan fungsi tersebut ke Netlify untuk menjadikannya tersedia untuk digunakan.

Menggunakan Netlify

Untuk menggunakan fungsi kami ke Netlify, jalankan arahan berikut:

npm install linkedin-api-js-client

# or with yarn
yarn add linkedin-api-js-client

CLI menggunakan fungsi ke persekitaran pengeluaran Netlify anda. Anda kemudiannya boleh mencari titik akhir fungsi dalam papan pemuka Netlify.

Penting: Pastikan untuk mengkonfigurasi pembolehubah persekitaran LINKEDIN_ACCESS_TOKEN dalam papan pemuka. Langkah ini penting untuk fungsi mengesahkan dan beroperasi dengan betul.

---

Ringkasan

Kami telah berjaya membina API tanpa pelayan untuk berkongsi URL artikel di LinkedIn bagi pihak pengguna, dengan memanfaatkan fungsi Pelanggan JavaScript API LinkedIn dan Netlify tanpa pelayan. Ini menandakan satu langkah penting ke arah mengautomasikan proses perkongsian media sosial untuk siaran blog.

Dari sini, kami boleh melanjutkan aliran kerja automasi untuk memasukkan platform media sosial lain dan tugasan yang dijadualkan. Contohnya, kami boleh menyepadukan platform seperti X (dahulunya Twitter), Facebook atau BlueSky dan menyesuaikan masa dan kandungan siaran untuk memaksimumkan penglibatan dan jangkauan khalayak.

Dengan itu, nantikan lebih banyak kemas kini tentang siri ini!

? Ketahui tentang Vue 3 dan TypeScript dengan buku baharu saya Learning Vue!

? Mahu menyokong saya? Belikan saya kopi.

Suka siaran ini atau rasa ia membantu? Kongsi?

Atas ialah kandungan terperinci Membina Automasi Media Sosial: Perkongsian LinkedIn dengan Fungsi Tanpa Pelayan. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!