如何通过LinkedIn API v2/UGC post API发布（而非共享）文章

Question

用例

作为领英授权用户
我想通过领英API发布文章
这样我的外部服务可以代表我创建内容

描述

我想通过LinkedIn API v2在LinkedIn上发布（而不是分享）一篇文章。

到目前为止，我已经成功地分享了文本、图像和文章网址。然而，创建一篇文章（发布文章），我不完全明白如何做到这一点。

有文章应用编程接口，但该应用编程接口只有检索已发布文章的方法。在留档中，UGC文章应用编程接口被引用为发布机制。

在UGC Post API的文档中，我只能找到用于共享文本、图像和文章URL的文档。我完全错过了这篇文章的创作。

在LinkedIn网站上发布此类文章的手动方式是访问LinkedIn Publishing，网址为https://www.linkedin.com/post/new并通过可视化编辑器创建内容。

但是，并非所有用户都可以使用发布。如果只有一个用户可以使用，则LinkedIn可能会自动做出决定。这在这里的文件中有说明。

发布当前并非对所有成员都可用，并且发布权限不受您的帐户类型的决定或影响。免费和高级帐户都可以进行发布。拥有高级帐户并不能保证发布权限。

问题

• 甚至可以用LinkedIn API v2发布文章吗
• 如何通过LinkedIn API v2发布文章
• 除了为UGC Post API（w_member_social）指定的权限外，是否还需要其他权限

现有失败的请求

// request
{
    method: 'POST',
    headers: {
        Authorization: `Bearer ${accessToken}`,
        'X-Restli-Protocol-Version': '2.0.0'
    },
    uri: `${LINKEDIN_API_URL}/v2/ugcPosts`,
    json: true,
    body: {
        author: `urn:li:person:${linkedinUserId}`,
        lifecycleState: 'PUBLISHED',
        specificContent: {
            'com.linkedin.ugc.ShareContent': {
                shareCommentary: {
                    text: `<strong>Let's hope this is possible</strong><br/>it would be bad if not<br/>said by me at ${new Date()}`
                },
                shareMediaCategory: 'URN_REFERENCE'
            }
        },
        visibility: {
            'com.linkedin.ugc.MemberNetworkVisibility': 'PUBLIC'
        }
    }
}

// response
{
    statusCode: 500,
    body: {
        message: 'INTERNAL SERVER ERROR',
        status: 500
    }
}

Answer 1

// request
{
    method: 'POST',
    headers: {
        Authorization: `Bearer ${accessToken}`,
        'X-Restli-Protocol-Version': '2.0.0'
    },
    uri: `${LINKEDIN_API_URL}/v2/ugcPosts`,
    json: true,
    body: {
        author: `urn:li:person:${linkedinUserId}`,
        lifecycleState: 'PUBLISHED',
        specificContent: {
            'com.linkedin.ugc.ShareContent': {
                shareCommentary: {
                    text: `<strong>Let's hope this is possible</strong><br/>it would be bad if not<br/>said by me at ${new Date()}`
                },
                shareMediaCategory: 'NONE'
            }
        },
        visibility: {
            'com.linkedin.ugc.MemberNetworkVisibility': 'PUBLIC'
        }
    }
}

Answer 2

文档在这里！

有效载荷应该是这样的：

{"content": {
    "contentEntities": [
        {
            "entityLocation": "https://www.example.com/content.html",
            "thumbnails": [
                {
                    "resolvedUrl": "https://www.example.com/image.jpg"
                }
            ]
        }
    ],
    "title": "Test Share with Content"
},
"distribution": {
    "linkedInDistributionTarget": {}
},
"owner": "urn:li:person:324_kGGaLE",
"subject": "Test Share Subject",
"text": {
    "text": "Test Share!"
}}