OBJECT

SocialPost

A post of a TDO to a social Destination, from the moment it is submitted and accepted.

A publish that is still queued, or that failed before it could be submitted, has no SocialPost and appears only in Processing Center. A SocialPost is not proof of publication — read publishStatus.

link GraphQL Schema definition

1type SocialPost {
2
3id: ID!
4
5# The distributed TDO.
6tdoId: ID!
7
8# Null when the TDO is no longer available. Requires the `recording.read` or
9# `aiware.tdo.read` scope: without
10# it the field is null and each post in the result adds an error to `errors`, so
11# leave it out of the selection.
12temporalDataObject: TemporalDataObject
13
14destinationId: ID!
15
16# Null when the destination has been deleted; read the network from `platform`,
17# which is always set.
18destination: Destination
19
20# The network the post was published to, e.g. "youtube", as recorded when it was
21# published.
22platform: String!
23
24# Whether the post is live: POSTED means it is, and `destinationUrl` is set. Use
25# this, not
26# `publishingTask.status`, to decide whether to link to the post. A post still
27# PENDING 90 days after
28# it was submitted is no longer checked and will not change.
29publishStatus: SocialPostStatus!
30
31# The task that published the post, as Processing Center shows it. Null when the
32# task is no longer
33# available. Requires the `task.read` scope: without it the field is null and each
34# post in the result adds an
35# error to `errors`, so leave it out of the selection.
36#
37# Its status can read `failed`, with a failure reason, while `publishStatus` is
38# PENDING: a slow publish may
39# still go live after its task has stopped waiting for it. Read `publishStatus` to
40# learn whether the post
41# failed.
42publishingTask: Task
43
44# Public URL of the post; set once POSTED. Null while PENDING and on a post that
45# never went live.
46destinationUrl: String
47
48# When the post was confirmed live, not when it was submitted. Null until POSTED.
49publishedAt: DateTime
50
51# When the post was submitted and accepted.
52createdDateTime: DateTime!
53
54modifiedDateTime: DateTime!
55
56# A post that has not synced yet reports `syncStatus: NEVER_SYNCED`. Null only
57# when the analytics could
58# not be read, with the cause in `errors`; the rest of the post is still returned.
59analytics: SocialPostAnalytics
60
61}