> ## Documentation Index > Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Threads API > Các tùy chọn để đăng bài bằng Threads API Xuất bản Threads lấy phương tiện từ URL của bạn thông qua trình thu thập dữ liệu phía máy chủ của Meta. Nếu bạn thấy mã lỗi Ayrshare 379 — đặc biệt là bên cạnh lỗi Instagram 440 hoặc 138 trong cùng lần xuất bản — xem [Meta Media Crawler Blocked](/help-center/technical-support/meta_media_crawler_blocked). ## Đăng bài lên Threads JSON cho một bài đăng cơ bản với liên kết và hình ảnh bằng Threads API: ```json Threads Post theme={"system"} { "post": "The best Threads post ever #best #awesome https://www.threads.net", // empty string is allowed "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], "platforms": ["threads"] } ``` Threads API có các yêu cầu và hạn chế sau: ## Tùy chọn Threads Bạn có thể đặt các tùy chọn bổ sung cho bài đăng bằng cách sử dụng tham số `threadsOptions`. ```json Threads Options theme={"system"} { "threadsOptions": { "allowCountries": ["US", "CA"], "thread": true, "threadNumber": true, "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"] // used when sending as a thread of threads } } ``` Các tùy chọn Threads là các trường tùy chọn có thể được dùng để kiểm soát bài đăng. Giới hạn bài đăng đến các quốc gia cụ thể bằng mã quốc gia. Sử dụng [mã quốc gia](/iso-codes/country). Chỉ khả dụng nếu Meta đã bật giới hạn địa lý cho tài khoản của bạn. Xem [Threads Geo Restrictions](/apis/post/social-networks/threads#geo-restrictions) để biết thêm thông tin. Chia các bài đăng dài thành một chuỗi thread được kết nối với đánh số và phương tiện tùy chọn. Xem [Thread](/apis/post/social-networks/threads#thread) để biết thêm thông tin. Tự động thêm số ở cuối mỗi thread theo định dạng 1/n. Yêu cầu `thread: true`. Thêm các đối tượng phương tiện vào một thread of threads. Một đối tượng phương tiện sẽ được thêm vào mỗi thread theo thứ tự. Sử dụng `null` để bỏ qua phương tiện cho một thread cụ thể. Sử dụng các đối tượng với nhiều URL để nhiều phương tiện cho mỗi thread. Xem [Thread Media](/apis/post/social-networks/threads#thread-media) để biết thêm thông tin. ## Thêm ngắt dòng hoặc văn bản phong phú vào bài đăng Threads Có thể thêm ngắt dòng Threads vào một bài đăng bằng [ký tự dòng mới](/apis/post/post#line-breaks) đặc biệt. Văn bản phong phú, chẳng hạn như chữ đậm hoặc nghiêng, có thể được thêm vào bài đăng Threads bằng một vài [phần tử html](/apis/post/overview#rich-text-posts). ## Carousel hình ảnh và video Bạn có thể đăng nhiều hình ảnh hoặc video lên Threads dưới dạng carousel; tối đa tổng cộng 20 hình ảnh hoặc video có thể được dùng trong một carousel. Chỉ cần thêm hình ảnh hoặc video bổ sung của bạn vào mảng `mediaUrls` và carousel sẽ được tạo tự động. ```json theme={"system"} "mediaUrls": ["https://url.com/image.jpg", "https://url.com/video.mp4" ...]; // Max 20 images or videos ``` URL video phải kết thúc bằng phần mở rộng đã biết như mp4. ## Giới hạn ký tự Vui lòng xem [Giới hạn ký tự Threads](/help-center/technical-support/character_limits#threads-character-limits) để biết thêm thông tin. ## Giới hạn địa lý Bạn có thể giới hạn một bài đăng đến một hoặc nhiều quốc gia cụ thể bằng mảng `allowCountries`. ```json theme={"system"} { "threadsOptions": { "allowCountries": ["US", "CA"] } } ``` Giới hạn địa lý (geo-gating) trên Threads chỉ khả dụng nếu Meta đã bật tính năng này cho tài khoản của bạn. Meta quyết định tài khoản Threads nào đủ điều kiện áp dụng giới hạn địa lý dựa trên các yếu tố như xác minh tài khoản, số người theo dõi, hoặc trạng thái người tạo nội dung. Nếu tài khoản của bạn đủ điều kiện, bạn sẽ thấy cài đặt địa lý (biểu tượng quả cầu) trong trình soạn bài đăng khi tạo bài đăng Threads mới. Bạn có thể kiểm tra xem một user profile có đủ điều kiện áp dụng giới hạn địa lý Threads hay không bằng cách kiểm tra thuộc tính `isEligibleForGeoRestrictions` trong endpoint [/user](/apis/user/profile-details). ## Nhắc tên (Mention) trên Threads Nhắc tên một handle Threads khác bằng cách thêm @handle vào nội dung bài đăng. Ví dụ: ```json theme={"system"} { "post": "The best social media API @Ayrshare ever!", "mediaUrls": ["https://images.com"], "platforms": ["threads"] } ``` Người dùng được @mention sẽ được thông báo về việc nhắc tên. Vui lòng xem lại [các quy tắc quan trọng](/testing/post-verification#mentions) về nhắc tên. Nếu đã đạt đến hạn mức, một thông báo lỗi sẽ được trả về. ## Thread Một thread Threads, còn được gọi là threadstorm, là một chuỗi các bài đăng được kết nối trên Threads cho phép bạn chia sẻ những ý tưởng dài hơn giới hạn ký tự của một bài đăng đơn lẻ, xuất hiện như một câu chuyện liên tục khi xem cùng nhau. ### Đăng một Thread Một thread Threads có thể được đăng qua API. Một thread là một bài đăng được chia thành một tập hợp các bài đăng phản hồi liên kết với nhau trong Threads. Bạn có thể tự động chia bài đăng hoặc chỉ định các [điểm ngắt thread](/apis/post/social-networks/threads#thread-breaks) trong nội dung bài đăng. ```json Threads Thread theme={"system"} { "threadsOptions": { "thread": true, // required for threadstorm "threadNumber": true, // optional to add numbers to each thread "mediaUrls": ["https://site.com/image1.png", "https://site.com/image2.png", ...] // optional one media object is added to a thread in order } } ``` #### Thread Media ##### Bỏ qua phương tiện Bỏ qua phương tiện cho một thread bằng cách sử dụng `null` trong mảng. Ví dụ: `["https://site.com/image1.png", null, "https://site.com/image2.png"]` Điều này sẽ đặt image1 lên bài đăng đầu tiên, không có hình ảnh trên bài đăng thứ hai, và image2 trên bài đăng thứ ba. ##### Nhiều phương tiện Nhiều đối tượng phương tiện có thể được thêm vào một bài đăng duy nhất trong một thread bằng cách thêm một đối tượng `{}` với các URL phương tiện trong mảng `mediaUrls`. Bất kỳ khóa đối tượng duy nhất nào cũng có thể được sử dụng. Ví dụ: ```json Threads Thread with Multiple Media URLs theme={"system"} { "threadsOptions": { "thread": true, "threadNumber": true, "mediaUrls": [ "https://img.ayrshare.com/random/photo-1.jpg", { "1": "https://img.ayrshare.com/random/photo-2.jpg", "2": "https://img.ayrshare.com/random/photo-3.jpg" }, "https://img.ayrshare.com/random/photo-4.jpg" ] } } ``` Trong ví dụ này, bài đăng đầu tiên sẽ chứa photo-1.jpg, bài đăng thứ hai photo-2.jpg và photo-3.jpg, và bài đăng thứ ba photo-4.jpg. #### Thread Breaks Ayrshare tự động chia nội dung bài đăng thành các bài đăng có độ dài phù hợp (> 500 ký tự) cho Threads. Khi tạo threads, chúng tôi ưu tiên giữ các câu hoàn chỉnh trong một bài đăng khi có thể. Nếu một câu không vừa, chúng tôi chia giữa các câu. Đối với những câu rất dài, chúng tôi chia giữa các từ. Trong những trường hợp hiếm hoi mà một từ quá dài, chúng tôi chia chính từ đó. Bạn cũng có thể thêm thủ công các đoạn văn với `\n\n` vào nội dung bài đăng để chỉ ra rằng một thread duy nhất nên được tạo. Nếu bạn có `\n\n` trong nội dung bài đăng, chúng tôi sẽ không tự động chia bài đăng thành các thread. Ví dụ: ```json Example Threads Thread theme={"system"} { "post": "This is post 1\n\nThis is post 2.", "platforms": ["threads"], "threadsOptions": { "thread": true } } ``` sẽ dẫn đến hai bài đăng trong thread. Nếu bạn muốn thêm đoạn văn nhưng không chia thành các bài đăng, hãy sử dụng `\u2063\n\u2063\n`. ```json Threads Thread with Paragraphs theme={"system"} { "post": "This is paragraph 1\u2063\n\u2063\nThis is paragraph 2.", "platforms": ["threads"], "threadsOptions": { "thread": true } } ``` sẽ dẫn đến một bài đăng với hai đoạn văn vì bài đăng dưới 500 ký tự. ### Xóa một Thread Threads không hỗ trợ xóa qua API. Việc xóa phải được thực hiện thủ công bằng ứng dụng Threads.