Analys och insikter
Spara en version av ett anpassat mätvärde
Spara en version av ett anpassat mätvärde. Använder den uttryckligen angivna och granskade datamängden och versionen; källan uppdateras inte automatiskt. Indata för rendering kan skickas via en pipe till sosoapi report render --output FILE.
POST /analytics-api/reporting/metrics/saveKontrakt granskat: · sha256:d6e85a113e8fb367
Översikt
Spara en version av ett anpassat mätvärde. Använder den uttryckligen angivna och granskade datamängden och versionen; källan uppdateras inte automatiskt. Indata för rendering kan skickas via en pipe till sosoapi report render --output FILE.
Ett lyckat HTTP-svar kan betyda att en begäran accepterats snarare än slutförts. Spara returnerat ID för bakgrundsarbete och kontrollera samma åtgärd tills den är klar. Ett schemalagt eller accepterat inlägg är publicerat först när plattformen bekräftar det; en klienttimeout fastställer inte resultatet.
Autentisering och behörigheter
En token får endast använda ägarens rättigheter. Varje anrop kontrollerar arbetsytemedlemskap, resursägarskap, valda arbetsytor och beviljade funktioner. Profilerna core och full ändrar vilka verktyg som visas; de ger ingen åtkomst.
Anropsfält
Obligatoriskt betyder obligatoriskt inom sitt överordnade objekt och vald gren. Ett obligatoriskt underfält gör inte ett valfritt överordnat objekt obligatoriskt. Regler och fältnamn nedan kopieras från kontraktet.
| Fält / gren | Typ / obligatoriskt | Begränsningar |
|---|---|---|
$ | objectObligatoriskt i överordnat objekt |
|
workspace_id | stringObligatoriskt i överordnat objekt |
|
formula | objectObligatoriskt i överordnat objekt |
|
formula.contractVersion | stringObligatoriskt i överordnat objekt |
|
formula.id | stringObligatoriskt i överordnat objekt |
|
formula.workspaceId | stringObligatoriskt i överordnat objekt |
|
formula.name | stringObligatoriskt i överordnat objekt |
|
formula.version | integerObligatoriskt i överordnat objekt |
|
formula.expression | stringObligatoriskt i överordnat objekt |
|
formula.fields | arrayObligatoriskt i överordnat objekt |
|
formula.fields[] | objectValfritt / objekt |
|
formula.fields[].identifier | stringObligatoriskt i överordnat objekt |
|
formula.fields[].selector | objectObligatoriskt i överordnat objekt |
|
formula.fields[].selector.platform | stringObligatoriskt i överordnat objekt |
|
formula.fields[].selector.key | stringObligatoriskt i överordnat objekt |
|
formula.fields[].selector.definition | stringObligatoriskt i överordnat objekt |
|
formula.fields[].selector.unit | stringObligatoriskt i överordnat objekt |
|
formula.fields[].selector.grain | stringObligatoriskt i överordnat objekt |
|
formula.fields[].selector.measurementKind | stringObligatoriskt i överordnat objekt |
|
formula.fields[].selector.nativePeriod | string | nullObligatoriskt i överordnat objekt | — |
formula.fields[].selector.nativePeriodanyOf 1 | stringObligatoriskt i överordnat objekt |
|
formula.fields[].selector.nativePeriodanyOf 2 | nullObligatoriskt i överordnat objekt | — |
formula.fields[].selector.timezone | string | nullObligatoriskt i överordnat objekt | — |
formula.fields[].selector.timezoneanyOf 1 | stringObligatoriskt i överordnat objekt |
|
formula.fields[].selector.timezoneanyOf 2 | nullObligatoriskt i överordnat objekt | — |
formula.fields[].aggregation | stringObligatoriskt i överordnat objekt |
|
formula.rounding | objectObligatoriskt i överordnat objekt |
|
formula.rounding.decimalPlaces | integerObligatoriskt i överordnat objekt |
|
formula.rounding.mode | stringObligatoriskt i överordnat objekt |
|
dataset | objectObligatoriskt i överordnat objekt |
|
dataset.contractVersion | stringObligatoriskt i överordnat objekt |
|
dataset.id | stringObligatoriskt i överordnat objekt |
|
dataset.reviewedAt | stringObligatoriskt i överordnat objekt |
|
dataset.selection | objectObligatoriskt i överordnat objekt |
|
dataset.selection.workspaceId | stringObligatoriskt i överordnat objekt |
|
dataset.selection.accountIds | arrayObligatoriskt i överordnat objekt |
|
dataset.selection.accountIds[] | stringValfritt / objekt |
|
dataset.selection.platforms | arrayObligatoriskt i överordnat objekt |
|
dataset.selection.platforms[] | stringValfritt / objekt |
|
dataset.selection.startDate | stringObligatoriskt i överordnat objekt |
|
dataset.selection.endDate | stringObligatoriskt i överordnat objekt |
|
dataset.selection.timezone | stringObligatoriskt i överordnat objekt |
|
dataset.accounts | arrayObligatoriskt i överordnat objekt |
|
dataset.accounts[] | objectValfritt / objekt |
|
dataset.accounts[].id | stringObligatoriskt i överordnat objekt |
|
dataset.accounts[].workspaceId | stringObligatoriskt i överordnat objekt |
|
dataset.accounts[].platform | stringObligatoriskt i överordnat objekt |
|
dataset.accounts[].name | stringObligatoriskt i överordnat objekt |
|
dataset.accounts[].connectionStatus | stringValfritt / objekt |
|
dataset.accounts[].healthMessage | stringValfritt / objekt |
|
dataset.posts | arrayObligatoriskt i överordnat objekt |
|
dataset.posts[] | objectValfritt / objekt |
|
dataset.posts[].social_post_id | stringObligatoriskt i överordnat objekt |
|
dataset.posts[].workspace_id | stringObligatoriskt i överordnat objekt |
|
dataset.posts[].social_account_id | stringObligatoriskt i överordnat objekt |
|
dataset.posts[].platform | stringObligatoriskt i överordnat objekt |
|
dataset.posts[].provider_post_id | stringObligatoriskt i överordnat objekt |
|
dataset.posts[].provider_published_at | string | nullObligatoriskt i överordnat objekt | — |
dataset.posts[].provider_published_atanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.posts[].provider_published_atanyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.posts[].content_format | string | nullObligatoriskt i överordnat objekt | — |
dataset.posts[].content_formatanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.posts[].content_formatanyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.posts[].permalink | string | nullObligatoriskt i överordnat objekt | — |
dataset.posts[].permalinkanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.posts[].permalinkanyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.posts[].provider_state | stringObligatoriskt i överordnat objekt |
|
dataset.posts[].first_seen_at | stringObligatoriskt i överordnat objekt |
|
dataset.posts[].last_seen_at | stringObligatoriskt i överordnat objekt |
|
dataset.posts[].scheduled_post_id | string | nullObligatoriskt i överordnat objekt | — |
dataset.posts[].scheduled_post_idanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.posts[].scheduled_post_idanyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.posts[].provenance | objectObligatoriskt i överordnat objekt |
|
dataset.posts[].provenance.provider | stringObligatoriskt i överordnat objekt |
|
dataset.posts[].provenance.source | stringObligatoriskt i överordnat objekt |
|
dataset.posts[].provenance.source_job_id | string | nullObligatoriskt i överordnat objekt | — |
dataset.posts[].provenance.source_job_idanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.posts[].provenance.source_job_idanyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.posts[].provenance.provider_api_version | string | nullObligatoriskt i överordnat objekt | — |
dataset.posts[].provenance.provider_api_versionanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.posts[].provenance.provider_api_versionanyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.posts[].provenance.schema_version | string | nullObligatoriskt i överordnat objekt | — |
dataset.posts[].provenance.schema_versionanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.posts[].provenance.schema_versionanyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.sources | arrayObligatoriskt i överordnat objekt |
|
dataset.sources[] | objectValfritt / objekt |
|
dataset.sources[].accountId | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].platform | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].resourceKind | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].providerResourceId | string | nullObligatoriskt i överordnat objekt | — |
dataset.sources[].providerResourceIdanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].providerResourceIdanyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.sources[].requestId | string | nullObligatoriskt i överordnat objekt | — |
dataset.sources[].requestIdanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].requestIdanyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.sources[].status | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].reason | string | nullObligatoriskt i överordnat objekt | — |
dataset.sources[].reasonanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].reasonanyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.sources[].envelope | object | nullObligatoriskt i överordnat objekt | — |
dataset.sources[].envelopeanyOf 1 | objectObligatoriskt i överordnat objekt |
|
dataset.sources[].envelope.contract_versionanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].envelope.request_idanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].envelope.platformanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].envelope.resourceanyOf 1 | objectObligatoriskt i överordnat objekt |
|
dataset.sources[].envelope.resource.kindanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].envelope.resource.social_account_idanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].envelope.resource.provider_resource_idanyOf 1 | string | nullObligatoriskt i överordnat objekt | — |
dataset.sources[].envelope.provider_api_versionanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].envelope.fetched_atanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].envelope.statusanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].envelope.availabilityanyOf 1 | arrayObligatoriskt i överordnat objekt |
|
dataset.sources[].envelope.availability[]anyOf 1 | objectValfritt / objekt |
|
dataset.sources[].envelope.availability[].scopeanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].envelope.availability[].statusanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].envelope.availability[].reasonanyOf 1 | stringValfritt / objekt |
|
dataset.sources[].envelope.availability[].diagnosticsanyOf 1 | objectValfritt / objekt |
|
dataset.sources[].envelope.availability[].diagnostics.http_statusanyOf 1 | integerObligatoriskt i överordnat objekt |
|
dataset.sources[].envelope.availability[].diagnostics.failed_stepanyOf 1 | stringValfritt / objekt |
|
dataset.sources[].envelope.availability[].diagnostics.provider_codeanyOf 1 | number | stringValfritt / objekt | — |
dataset.sources[].envelope.availability[].diagnostics.provider_codeanyOf 1 / anyOf 1 | numberValfritt / objekt | — |
dataset.sources[].envelope.availability[].diagnostics.provider_codeanyOf 1 / anyOf 2 | stringValfritt / objekt |
|
dataset.sources[].envelope.availability[].diagnostics.provider_subcodeanyOf 1 | number | stringValfritt / objekt | — |
dataset.sources[].envelope.availability[].diagnostics.provider_subcodeanyOf 1 / anyOf 1 | numberValfritt / objekt | — |
dataset.sources[].envelope.availability[].diagnostics.provider_subcodeanyOf 1 / anyOf 2 | stringValfritt / objekt |
|
dataset.sources[].envelope.availability[].diagnostics.provider_typeanyOf 1 | stringValfritt / objekt |
|
dataset.sources[].envelope.availability[].diagnostics.is_transientanyOf 1 | booleanValfritt / objekt | — |
dataset.sources[].envelope.availability[].diagnostics.provider_request_idanyOf 1 | stringValfritt / objekt |
|
dataset.sources[].envelope.availability[].diagnostics.accessanyOf 1 | objectValfritt / objekt |
|
dataset.sources[].envelope.availability[].diagnostics.access.login_modeanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].envelope.availability[].diagnostics.access.provider_hostanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].envelope.availability[].diagnostics.access.required_permissionsanyOf 1 | arrayObligatoriskt i överordnat objekt |
|
dataset.sources[].envelope.availability[].diagnostics.access.required_permissions[]anyOf 1 | stringValfritt / objekt |
|
dataset.sources[].envelope.availability[].diagnostics.access.current_connection_policy_permissionsanyOf 1 | arrayObligatoriskt i överordnat objekt |
|
dataset.sources[].envelope.availability[].diagnostics.access.current_connection_policy_permissions[]anyOf 1 | stringValfritt / objekt |
|
dataset.sources[].envelope.availability[].diagnostics.access.granted_permissionsanyOf 1 | array | nullObligatoriskt i överordnat objekt | — |
dataset.sources[].envelope.availability[].diagnostics.access.granted_permissionsanyOf 1 / anyOf 1 | arrayObligatoriskt i överordnat objekt |
|
dataset.sources[].envelope.availability[].diagnostics.access.granted_permissions[]anyOf 1 / anyOf 1 | stringValfritt / objekt |
|
dataset.sources[].envelope.availability[].diagnostics.access.granted_permissionsanyOf 1 / anyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.sources[].envelope.availability[].diagnostics.access.grant_evidenceanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].envelope.availability[].diagnostics.access.permission_stateanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].envelope.availability[].diagnostics.access.grant_observed_atanyOf 1 | stringValfritt / objekt |
|
dataset.sources[].envelope.availability[].diagnostics.access.app_accessanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].envelope.availability[].diagnostics.access.next_stepanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].envelope.provider_dataanyOf 1 | any JSON value | nullObligatoriskt i överordnat objekt | — |
dataset.sources[].envelope.provider_dataanyOf 1 / anyOf 1 | any JSON valueObligatoriskt i överordnat objekt | — |
dataset.sources[].envelope.provider_dataanyOf 1 / anyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.sources[].envelope.requested_date_rangeanyOf 1 | object | nullObligatoriskt i överordnat objekt | — |
dataset.sources[].envelope.requested_date_rangeanyOf 1 / anyOf 1 | objectObligatoriskt i överordnat objekt |
|
dataset.sources[].envelope.requested_date_range.start_dateanyOf 1 / anyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].envelope.requested_date_range.end_dateanyOf 1 / anyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].envelope.requested_date_rangeanyOf 1 / anyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.sources[].envelope.cacheanyOf 1 | objectObligatoriskt i överordnat objekt |
|
dataset.sources[].envelope.cache.authoritativeanyOf 1 | booleanObligatoriskt i överordnat objekt |
|
dataset.sources[].envelope.cache.statusanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].envelope.cache.expires_atanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].envelopeanyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.sources[].metrics | arrayObligatoriskt i överordnat objekt |
|
dataset.sources[].metrics[] | objectValfritt / objekt |
|
dataset.sources[].metrics[].key | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].metrics[].definition | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].metrics[].unit | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].metrics[].grain | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].metrics[].value | number | nullObligatoriskt i överordnat objekt | — |
dataset.sources[].metrics[].availability | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].metrics[].reason | string | nullObligatoriskt i överordnat objekt | — |
dataset.sources[].metrics[].reasonanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].metrics[].reasonanyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.sources[].metrics[].measurement | objectObligatoriskt i överordnat objekt |
|
dataset.sources[].metrics[].measurement.kind | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].metrics[].measurement.period | string | nullObligatoriskt i överordnat objekt | — |
dataset.sources[].metrics[].measurement.periodanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].metrics[].measurement.periodanyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.sources[].metrics[].measurement.start | string | nullObligatoriskt i överordnat objekt | — |
dataset.sources[].metrics[].measurement.startanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].metrics[].measurement.startanyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.sources[].metrics[].measurement.end | string | nullObligatoriskt i överordnat objekt | — |
dataset.sources[].metrics[].measurement.endanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].metrics[].measurement.endanyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.sources[].metrics[].measurement.timezone | string | nullObligatoriskt i överordnat objekt | — |
dataset.sources[].metrics[].measurement.timezoneanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.sources[].metrics[].measurement.timezoneanyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.sources[].metrics[].sourcePath | stringObligatoriskt i överordnat objekt |
|
dataset.coverage | objectObligatoriskt i överordnat objekt |
|
dataset.coverage.population | stringObligatoriskt i överordnat objekt |
|
dataset.coverage.postsComplete | booleanObligatoriskt i överordnat objekt | — |
dataset.coverage.nextCursor | string | nullObligatoriskt i överordnat objekt | — |
dataset.coverage.nextCursoranyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.coverage.nextCursoranyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.coverage.postLimit | integerObligatoriskt i överordnat objekt |
|
dataset.coverage.postInsightsLimit | integerObligatoriskt i överordnat objekt |
|
dataset.coverage.omittedPostInsights | integerObligatoriskt i överordnat objekt |
|
dataset.coverage.notes | arrayObligatoriskt i överordnat objekt |
|
dataset.coverage.notes[] | stringValfritt / objekt |
|
dataset.customMetrics | arrayObligatoriskt i överordnat objekt |
|
dataset.customMetrics[] | objectValfritt / objekt |
|
dataset.customMetrics[].id | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].name | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].version | integerObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].expression | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].definition | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].unit | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].grain | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].rounding | objectObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].rounding.decimalPlaces | integerObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].rounding.mode | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].inputs | arrayObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].inputs[] | objectValfritt / objekt |
|
dataset.customMetrics[].inputs[].requestId | string | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].inputs[].requestIdanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].inputs[].requestIdanyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].inputs[].sourcePath | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].inputs[].value | number | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].inputs[].availability | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].value | number | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].availability | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].reason | string | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].reasonanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].reasonanyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].formula | objectValfritt / objekt |
|
dataset.customMetrics[].formula.contractVersion | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].formula.id | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].formula.workspaceId | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].formula.name | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].formula.version | integerObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].formula.expression | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].formula.fields | arrayObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].formula.fields[] | objectValfritt / objekt |
|
dataset.customMetrics[].formula.fields[].identifier | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].formula.fields[].selector | objectObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].formula.fields[].selector.platform | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].formula.fields[].selector.key | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].formula.fields[].selector.definition | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].formula.fields[].selector.unit | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].formula.fields[].selector.grain | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].formula.fields[].selector.measurementKind | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].formula.fields[].selector.nativePeriod | string | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].formula.fields[].selector.nativePeriodanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].formula.fields[].selector.nativePeriodanyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].formula.fields[].selector.timezone | string | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].formula.fields[].selector.timezoneanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].formula.fields[].selector.timezoneanyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].formula.fields[].aggregation | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].formula.rounding | objectObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].formula.rounding.decimalPlaces | integerObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].formula.rounding.mode | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation | objectValfritt / objekt |
|
dataset.customMetrics[].calculation.contractVersion | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.workspaceId | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.datasetId | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.formulaId | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.name | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.version | integerObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.expression | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.rounding | objectObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.rounding.decimalPlaces | integerObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.rounding.mode | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.value | number | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].calculation.unit | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.status | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.code | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.reason | string | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].calculation.reasonanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.reasonanyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].calculation.excludedInputIds | arrayObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.excludedInputIds[] | stringValfritt / objekt |
|
dataset.customMetrics[].calculation.inputs | arrayObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.inputs[] | objectValfritt / objekt |
|
dataset.customMetrics[].calculation.inputs[].inputId | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.inputs[].selector | objectObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.inputs[].selector.platform | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.inputs[].selector.key | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.inputs[].selector.definition | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.inputs[].selector.unit | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.inputs[].selector.grain | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.inputs[].selector.measurementKind | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.inputs[].selector.nativePeriod | string | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].calculation.inputs[].selector.nativePeriodanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.inputs[].selector.nativePeriodanyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].calculation.inputs[].selector.timezone | string | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].calculation.inputs[].selector.timezoneanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.inputs[].selector.timezoneanyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].calculation.inputs[].value | number | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].calculation.inputs[].availability | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.inputs[].reason | string | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].calculation.inputs[].reasonanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.inputs[].reasonanyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].calculation.inputs[].measurement | objectObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.inputs[].measurement.kind | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.inputs[].measurement.period | string | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].calculation.inputs[].measurement.periodanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.inputs[].measurement.periodanyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].calculation.inputs[].measurement.start | string | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].calculation.inputs[].measurement.startanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.inputs[].measurement.startanyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].calculation.inputs[].measurement.end | string | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].calculation.inputs[].measurement.endanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.inputs[].measurement.endanyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].calculation.inputs[].measurement.timezone | string | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].calculation.inputs[].measurement.timezoneanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.inputs[].measurement.timezoneanyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].calculation.inputs[].requestId | string | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].calculation.inputs[].requestIdanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.inputs[].requestIdanyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].calculation.inputs[].sourcePath | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.inputs[].accountId | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.inputs[].providerResourceId | string | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].calculation.inputs[].providerResourceIdanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.inputs[].providerResourceIdanyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].calculation.inputs[].fetchedAt | string | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].calculation.inputs[].fetchedAtanyOf 1 | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.inputs[].fetchedAtanyOf 2 | nullObligatoriskt i överordnat objekt | — |
dataset.customMetrics[].calculation.inputs[].identifier | stringObligatoriskt i överordnat objekt |
|
dataset.customMetrics[].calculation.inputs[].included | booleanObligatoriskt i överordnat objekt | — |
excluded_input_ids | arrayValfritt / objekt |
|
excluded_input_ids[] | stringValfritt / objekt |
|
expected_version | integer | nullObligatoriskt i överordnat objekt | — |
expected_versionanyOf 1 | integerObligatoriskt i överordnat objekt |
|
expected_versionanyOf 2 | nullObligatoriskt i överordnat objekt | — |
mutation_id | stringObligatoriskt i överordnat objekt |
|
calculation | objectValfritt / objekt |
|
calculation.contractVersion | stringObligatoriskt i överordnat objekt |
|
calculation.workspaceId | stringObligatoriskt i överordnat objekt |
|
calculation.datasetId | stringObligatoriskt i överordnat objekt |
|
calculation.formulaId | stringObligatoriskt i överordnat objekt |
|
calculation.name | stringObligatoriskt i överordnat objekt |
|
calculation.version | integerObligatoriskt i överordnat objekt |
|
calculation.expression | stringObligatoriskt i överordnat objekt |
|
calculation.rounding | objectObligatoriskt i överordnat objekt |
|
calculation.rounding.decimalPlaces | integerObligatoriskt i överordnat objekt |
|
calculation.rounding.mode | stringObligatoriskt i överordnat objekt |
|
calculation.value | number | nullObligatoriskt i överordnat objekt | — |
calculation.unit | stringObligatoriskt i överordnat objekt |
|
calculation.status | stringObligatoriskt i överordnat objekt |
|
calculation.code | stringObligatoriskt i överordnat objekt |
|
calculation.reason | string | nullObligatoriskt i överordnat objekt | — |
calculation.reasonanyOf 1 | stringObligatoriskt i överordnat objekt |
|
calculation.reasonanyOf 2 | nullObligatoriskt i överordnat objekt | — |
calculation.excludedInputIds | arrayObligatoriskt i överordnat objekt |
|
calculation.excludedInputIds[] | stringValfritt / objekt |
|
calculation.inputs | arrayObligatoriskt i överordnat objekt |
|
calculation.inputs[] | objectValfritt / objekt |
|
calculation.inputs[].inputId | stringObligatoriskt i överordnat objekt |
|
calculation.inputs[].selector | objectObligatoriskt i överordnat objekt |
|
calculation.inputs[].selector.platform | stringObligatoriskt i överordnat objekt |
|
calculation.inputs[].selector.key | stringObligatoriskt i överordnat objekt |
|
calculation.inputs[].selector.definition | stringObligatoriskt i överordnat objekt |
|
calculation.inputs[].selector.unit | stringObligatoriskt i överordnat objekt |
|
calculation.inputs[].selector.grain | stringObligatoriskt i överordnat objekt |
|
calculation.inputs[].selector.measurementKind | stringObligatoriskt i överordnat objekt |
|
calculation.inputs[].selector.nativePeriod | string | nullObligatoriskt i överordnat objekt | — |
calculation.inputs[].selector.nativePeriodanyOf 1 | stringObligatoriskt i överordnat objekt |
|
calculation.inputs[].selector.nativePeriodanyOf 2 | nullObligatoriskt i överordnat objekt | — |
calculation.inputs[].selector.timezone | string | nullObligatoriskt i överordnat objekt | — |
calculation.inputs[].selector.timezoneanyOf 1 | stringObligatoriskt i överordnat objekt |
|
calculation.inputs[].selector.timezoneanyOf 2 | nullObligatoriskt i överordnat objekt | — |
calculation.inputs[].value | number | nullObligatoriskt i överordnat objekt | — |
calculation.inputs[].availability | stringObligatoriskt i överordnat objekt |
|
calculation.inputs[].reason | string | nullObligatoriskt i överordnat objekt | — |
calculation.inputs[].reasonanyOf 1 | stringObligatoriskt i överordnat objekt |
|
calculation.inputs[].reasonanyOf 2 | nullObligatoriskt i överordnat objekt | — |
calculation.inputs[].measurement | objectObligatoriskt i överordnat objekt |
|
calculation.inputs[].measurement.kind | stringObligatoriskt i överordnat objekt |
|
calculation.inputs[].measurement.period | string | nullObligatoriskt i överordnat objekt | — |
calculation.inputs[].measurement.periodanyOf 1 | stringObligatoriskt i överordnat objekt |
|
calculation.inputs[].measurement.periodanyOf 2 | nullObligatoriskt i överordnat objekt | — |
calculation.inputs[].measurement.start | string | nullObligatoriskt i överordnat objekt | — |
calculation.inputs[].measurement.startanyOf 1 | stringObligatoriskt i överordnat objekt |
|
calculation.inputs[].measurement.startanyOf 2 | nullObligatoriskt i överordnat objekt | — |
calculation.inputs[].measurement.end | string | nullObligatoriskt i överordnat objekt | — |
calculation.inputs[].measurement.endanyOf 1 | stringObligatoriskt i överordnat objekt |
|
calculation.inputs[].measurement.endanyOf 2 | nullObligatoriskt i överordnat objekt | — |
calculation.inputs[].measurement.timezone | string | nullObligatoriskt i överordnat objekt | — |
calculation.inputs[].measurement.timezoneanyOf 1 | stringObligatoriskt i överordnat objekt |
|
calculation.inputs[].measurement.timezoneanyOf 2 | nullObligatoriskt i överordnat objekt | — |
calculation.inputs[].requestId | string | nullObligatoriskt i överordnat objekt | — |
calculation.inputs[].requestIdanyOf 1 | stringObligatoriskt i överordnat objekt |
|
calculation.inputs[].requestIdanyOf 2 | nullObligatoriskt i överordnat objekt | — |
calculation.inputs[].sourcePath | stringObligatoriskt i överordnat objekt |
|
calculation.inputs[].accountId | stringObligatoriskt i överordnat objekt |
|
calculation.inputs[].providerResourceId | string | nullObligatoriskt i överordnat objekt | — |
calculation.inputs[].providerResourceIdanyOf 1 | stringObligatoriskt i överordnat objekt |
|
calculation.inputs[].providerResourceIdanyOf 2 | nullObligatoriskt i överordnat objekt | — |
calculation.inputs[].fetchedAt | string | nullObligatoriskt i överordnat objekt | — |
calculation.inputs[].fetchedAtanyOf 1 | stringObligatoriskt i överordnat objekt |
|
calculation.inputs[].fetchedAtanyOf 2 | nullObligatoriskt i överordnat objekt | — |
calculation.inputs[].identifier | stringObligatoriskt i överordnat objekt |
|
calculation.inputs[].included | booleanObligatoriskt i överordnat objekt | — |
Fullständigt JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"formula": {
"type": "object",
"properties": {
"contractVersion": {
"type": "string",
"const": "analytics-metric/v1"
},
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"workspaceId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"version": {
"type": "integer",
"minimum": 1,
"maximum": 1000000
},
"expression": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"fields": {
"maxItems": 32,
"type": "array",
"items": {
"type": "object",
"properties": {
"identifier": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]{0,63}$"
},
"selector": {
"type": "object",
"properties": {
"platform": {
"type": "string",
"enum": [
"facebook",
"instagram",
"threads",
"youtube"
]
},
"key": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_]{0,100}$"
},
"definition": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"unit": {
"type": "string",
"enum": [
"count",
"seconds",
"minutes",
"percent",
"ratio"
]
},
"grain": {
"type": "string",
"enum": [
"post",
"account"
]
},
"measurementKind": {
"type": "string",
"enum": [
"lifetime",
"snapshot",
"period",
"unknown"
]
},
"nativePeriod": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "null"
}
]
},
"timezone": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 100
},
{
"type": "null"
}
]
}
},
"required": [
"platform",
"key",
"definition",
"unit",
"grain",
"measurementKind",
"nativePeriod",
"timezone"
],
"additionalProperties": false
},
"aggregation": {
"type": "string",
"enum": [
"single",
"sum"
]
}
},
"required": [
"identifier",
"selector",
"aggregation"
],
"additionalProperties": false
}
},
"rounding": {
"type": "object",
"properties": {
"decimalPlaces": {
"type": "integer",
"minimum": 0,
"maximum": 8
},
"mode": {
"type": "string",
"const": "half_away_from_zero"
}
},
"required": [
"decimalPlaces",
"mode"
],
"additionalProperties": false
}
},
"required": [
"contractVersion",
"id",
"workspaceId",
"name",
"version",
"expression",
"fields",
"rounding"
],
"additionalProperties": false
},
"dataset": {
"type": "object",
"properties": {
"contractVersion": {
"type": "string",
"const": "analytics-report/v1"
},
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"reviewedAt": {
"type": "string",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
"format": "date-time"
},
"selection": {
"type": "object",
"properties": {
"workspaceId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"accountIds": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"platforms": {
"minItems": 1,
"maxItems": 4,
"type": "array",
"items": {
"type": "string",
"enum": [
"facebook",
"instagram",
"threads",
"youtube"
]
}
},
"startDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"endDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"timezone": {
"type": "string",
"minLength": 1,
"maxLength": 100
}
},
"required": [
"workspaceId",
"accountIds",
"platforms",
"startDate",
"endDate",
"timezone"
],
"additionalProperties": false
},
"accounts": {
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"workspaceId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"platform": {
"type": "string",
"enum": [
"facebook",
"instagram",
"threads",
"youtube"
]
},
"name": {
"type": "string",
"maxLength": 500
},
"connectionStatus": {
"type": "string",
"maxLength": 100
},
"healthMessage": {
"type": "string",
"maxLength": 1000
}
},
"required": [
"id",
"workspaceId",
"platform",
"name"
],
"additionalProperties": false
}
},
"posts": {
"maxItems": 1000,
"type": "array",
"items": {
"type": "object",
"properties": {
"social_post_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"social_account_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"platform": {
"type": "string",
"enum": [
"instagram",
"facebook",
"threads",
"youtube"
]
},
"provider_post_id": {
"type": "string",
"minLength": 1,
"maxLength": 512
},
"provider_published_at": {
"anyOf": [
{
"type": "string",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
"format": "date-time"
},
{
"type": "null"
}
]
},
"content_format": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 100
},
{
"type": "null"
}
]
},
"permalink": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"format": "uri"
},
{
"type": "null"
}
]
},
"provider_state": {
"type": "string",
"enum": [
"available",
"deleted",
"unavailable",
"unknown"
]
},
"first_seen_at": {
"type": "string",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
"format": "date-time"
},
"last_seen_at": {
"type": "string",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
"format": "date-time"
},
"scheduled_post_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
{
"type": "null"
}
]
},
"provenance": {
"type": "object",
"properties": {
"provider": {
"type": "string",
"enum": [
"instagram",
"facebook",
"threads",
"youtube"
]
},
"source": {
"type": "string",
"enum": [
"provider_api",
"provider_webhook",
"publication_outcome",
"backfill"
]
},
"source_job_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
{
"type": "null"
}
]
},
"provider_api_version": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 200
},
{
"type": "null"
}
]
},
"schema_version": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 200
},
{
"type": "null"
}
]
}
},
"required": [
"provider",
"source",
"source_job_id",
"provider_api_version",
"schema_version"
],
"additionalProperties": false
}
},
"required": [
"social_post_id",
"workspace_id",
"social_account_id",
"platform",
"provider_post_id",
"provider_published_at",
"content_format",
"permalink",
"provider_state",
"first_seen_at",
"last_seen_at",
"scheduled_post_id",
"provenance"
],
"additionalProperties": false
}
},
"sources": {
"maxItems": 30,
"type": "array",
"items": {
"type": "object",
"properties": {
"accountId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"platform": {
"type": "string",
"enum": [
"facebook",
"instagram",
"threads",
"youtube"
]
},
"resourceKind": {
"type": "string",
"enum": [
"account",
"post"
]
},
"providerResourceId": {
"anyOf": [
{
"type": "string",
"maxLength": 512
},
{
"type": "null"
}
]
},
"requestId": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
{
"type": "null"
}
]
},
"status": {
"type": "string",
"enum": [
"available",
"partial",
"not_returned",
"unsupported",
"permission_required",
"threshold_not_met",
"no_data",
"failed",
"pending",
"stale"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 8000
},
{
"type": "null"
}
]
},
"envelope": {
"anyOf": [
{
"type": "object",
"properties": {
"contract_version": {
"type": "string",
"const": "provider-insights/v1"
},
"request_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"platform": {
"type": "string",
"enum": [
"facebook",
"instagram",
"threads",
"youtube"
]
},
"resource": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"account",
"post"
]
},
"social_account_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"provider_resource_id": {
"type": [
"string",
"null"
]
}
},
"required": [
"kind",
"social_account_id",
"provider_resource_id"
],
"additionalProperties": false
},
"provider_api_version": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"fetched_at": {
"type": "string",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
"format": "date-time"
},
"status": {
"type": "string",
"enum": [
"available",
"partial",
"unavailable"
]
},
"availability": {
"minItems": 1,
"maxItems": 64,
"type": "array",
"items": {
"type": "object",
"properties": {
"scope": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"status": {
"type": "string",
"enum": [
"available",
"partial",
"not_returned",
"unsupported",
"permission_required",
"threshold_not_met",
"no_data",
"failed"
]
},
"reason": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"diagnostics": {
"type": "object",
"properties": {
"http_status": {
"type": "integer",
"minimum": 0,
"maximum": 599
},
"failed_step": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"provider_code": {
"anyOf": [
{
"type": "number"
},
{
"type": "string",
"maxLength": 100
}
]
},
"provider_subcode": {
"anyOf": [
{
"type": "number"
},
{
"type": "string",
"maxLength": 100
}
]
},
"provider_type": {
"type": "string",
"maxLength": 200
},
"is_transient": {
"type": "boolean"
},
"provider_request_id": {
"type": "string",
"maxLength": 200
},
"access": {
"type": "object",
"properties": {
"login_mode": {
"type": "string",
"enum": [
"instagram_login",
"facebook_login",
"threads_user"
]
},
"provider_host": {
"type": "string",
"maxLength": 200
},
"required_permissions": {
"maxItems": 16,
"type": "array",
"items": {
"type": "string",
"maxLength": 100
}
},
"current_connection_policy_permissions": {
"maxItems": 16,
"type": "array",
"items": {
"type": "string",
"maxLength": 100
}
},
"granted_permissions": {
"anyOf": [
{
"maxItems": 128,
"type": "array",
"items": {
"type": "string",
"maxLength": 100
}
},
{
"type": "null"
}
]
},
"grant_evidence": {
"type": "string",
"enum": [
"exact",
"unknown"
]
},
"permission_state": {
"type": "string",
"enum": [
"granted",
"missing",
"unknown"
]
},
"grant_observed_at": {
"type": "string",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
"format": "date-time"
},
"app_access": {
"type": "string",
"const": "unverified"
},
"next_step": {
"type": "string",
"maxLength": 1500
}
},
"required": [
"login_mode",
"provider_host",
"required_permissions",
"current_connection_policy_permissions",
"granted_permissions",
"grant_evidence",
"permission_state",
"app_access",
"next_step"
],
"additionalProperties": false
}
},
"required": [
"http_status"
],
"additionalProperties": false
}
},
"required": [
"scope",
"status"
],
"additionalProperties": false
}
},
"provider_data": {
"anyOf": [
{},
{
"type": "null"
}
]
},
"requested_date_range": {
"anyOf": [
{
"type": "object",
"properties": {
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"required": [
"start_date",
"end_date"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"cache": {
"type": "object",
"properties": {
"authoritative": {
"type": "boolean",
"const": false
},
"status": {
"type": "string",
"enum": [
"stored",
"hit",
"bypassed"
]
},
"expires_at": {
"type": "string",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
"format": "date-time"
}
},
"required": [
"authoritative",
"status",
"expires_at"
],
"additionalProperties": false
}
},
"required": [
"contract_version",
"request_id",
"platform",
"resource",
"provider_api_version",
"fetched_at",
"status",
"availability",
"provider_data",
"requested_date_range",
"cache"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"metrics": {
"maxItems": 5000,
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string",
"minLength": 1,
"maxLength": 150
},
"definition": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"unit": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"grain": {
"type": "string",
"enum": [
"post",
"account"
]
},
"value": {
"type": [
"number",
"null"
]
},
"availability": {
"type": "string",
"enum": [
"available",
"partial",
"not_returned",
"unsupported",
"permission_required",
"threshold_not_met",
"no_data",
"failed",
"pending",
"stale"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 4000
},
{
"type": "null"
}
]
},
"measurement": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"lifetime",
"snapshot",
"period",
"unknown"
]
},
"period": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
]
},
"start": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
]
},
"end": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
]
},
"timezone": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
]
}
},
"required": [
"kind",
"period",
"start",
"end",
"timezone"
],
"additionalProperties": false
},
"sourcePath": {
"type": "string",
"minLength": 1,
"maxLength": 2000
}
},
"required": [
"key",
"definition",
"unit",
"grain",
"value",
"availability",
"reason",
"measurement",
"sourcePath"
],
"additionalProperties": false
}
}
},
"required": [
"accountId",
"platform",
"resourceKind",
"providerResourceId",
"requestId",
"status",
"reason",
"envelope",
"metrics"
],
"additionalProperties": false
}
},
"coverage": {
"type": "object",
"properties": {
"population": {
"type": "string",
"const": "discovered_posts"
},
"postsComplete": {
"type": "boolean"
},
"nextCursor": {
"anyOf": [
{
"type": "string",
"maxLength": 16384
},
{
"type": "null"
}
]
},
"postLimit": {
"type": "integer",
"minimum": 0,
"maximum": 1000
},
"postInsightsLimit": {
"type": "integer",
"minimum": 0,
"maximum": 20
},
"omittedPostInsights": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"notes": {
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"maxLength": 2000
}
}
},
"required": [
"population",
"postsComplete",
"nextCursor",
"postLimit",
"postInsightsLimit",
"omittedPostInsights",
"notes"
],
"additionalProperties": false
},
"customMetrics": {
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"version": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"expression": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"definition": {
"type": "string",
"maxLength": 1000
},
"unit": {
"type": "string",
"maxLength": 100
},
"grain": {
"type": "string",
"enum": [
"post",
"account",
"compatible_sum"
]
},
"rounding": {
"type": "object",
"properties": {
"decimalPlaces": {
"type": "integer",
"minimum": 0,
"maximum": 8
},
"mode": {
"type": "string",
"const": "half_away_from_zero"
}
},
"required": [
"decimalPlaces",
"mode"
],
"additionalProperties": false
},
"inputs": {
"maxItems": 5000,
"type": "array",
"items": {
"type": "object",
"properties": {
"requestId": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
{
"type": "null"
}
]
},
"sourcePath": {
"type": "string",
"maxLength": 2000
},
"value": {
"type": [
"number",
"null"
]
},
"availability": {
"type": "string",
"enum": [
"available",
"partial",
"not_returned",
"unsupported",
"permission_required",
"threshold_not_met",
"no_data",
"failed",
"pending",
"stale"
]
}
},
"required": [
"requestId",
"sourcePath",
"value",
"availability"
],
"additionalProperties": false
}
},
"value": {
"type": [
"number",
"null"
]
},
"availability": {
"type": "string",
"enum": [
"available",
"partial",
"not_returned",
"unsupported",
"permission_required",
"threshold_not_met",
"no_data",
"failed",
"pending",
"stale"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 4000
},
{
"type": "null"
}
]
},
"formula": {
"type": "object",
"properties": {
"contractVersion": {
"type": "string",
"const": "analytics-metric/v1"
},
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"workspaceId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"version": {
"type": "integer",
"minimum": 1,
"maximum": 1000000
},
"expression": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"fields": {
"maxItems": 32,
"type": "array",
"items": {
"type": "object",
"properties": {
"identifier": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]{0,63}$"
},
"selector": {
"type": "object",
"properties": {
"platform": {
"type": "string",
"enum": [
"facebook",
"instagram",
"threads",
"youtube"
]
},
"key": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_]{0,100}$"
},
"definition": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"unit": {
"type": "string",
"enum": [
"count",
"seconds",
"minutes",
"percent",
"ratio"
]
},
"grain": {
"type": "string",
"enum": [
"post",
"account"
]
},
"measurementKind": {
"type": "string",
"enum": [
"lifetime",
"snapshot",
"period",
"unknown"
]
},
"nativePeriod": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "null"
}
]
},
"timezone": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 100
},
{
"type": "null"
}
]
}
},
"required": [
"platform",
"key",
"definition",
"unit",
"grain",
"measurementKind",
"nativePeriod",
"timezone"
],
"additionalProperties": false
},
"aggregation": {
"type": "string",
"enum": [
"single",
"sum"
]
}
},
"required": [
"identifier",
"selector",
"aggregation"
],
"additionalProperties": false
}
},
"rounding": {
"type": "object",
"properties": {
"decimalPlaces": {
"type": "integer",
"minimum": 0,
"maximum": 8
},
"mode": {
"type": "string",
"const": "half_away_from_zero"
}
},
"required": [
"decimalPlaces",
"mode"
],
"additionalProperties": false
}
},
"required": [
"contractVersion",
"id",
"workspaceId",
"name",
"version",
"expression",
"fields",
"rounding"
],
"additionalProperties": false
},
"calculation": {
"type": "object",
"properties": {
"contractVersion": {
"type": "string",
"const": "analytics-metric/v1"
},
"workspaceId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"datasetId": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"formulaId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"version": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"expression": {
"type": "string",
"maxLength": 1000
},
"rounding": {
"type": "object",
"properties": {
"decimalPlaces": {
"type": "integer",
"minimum": 0,
"maximum": 8
},
"mode": {
"type": "string",
"const": "half_away_from_zero"
}
},
"required": [
"decimalPlaces",
"mode"
],
"additionalProperties": false
},
"value": {
"type": [
"number",
"null"
]
},
"unit": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"status": {
"type": "string",
"enum": [
"available",
"not_returned"
]
},
"code": {
"type": "string",
"enum": [
"ok",
"invalid_expression",
"missing_input",
"incompatible_input",
"zero_denominator",
"numeric_limit",
"workspace_mismatch",
"ambiguous_input",
"unknown_exclusion"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 500
},
{
"type": "null"
}
]
},
"excludedInputIds": {
"maxItems": 5000,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 1500
}
},
"inputs": {
"maxItems": 5000,
"type": "array",
"items": {
"type": "object",
"properties": {
"inputId": {
"type": "string",
"minLength": 1,
"maxLength": 1500
},
"selector": {
"type": "object",
"properties": {
"platform": {
"type": "string",
"enum": [
"facebook",
"instagram",
"threads",
"youtube"
]
},
"key": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_]{0,100}$"
},
"definition": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"unit": {
"type": "string",
"enum": [
"count",
"seconds",
"minutes",
"percent",
"ratio"
]
},
"grain": {
"type": "string",
"enum": [
"post",
"account"
]
},
"measurementKind": {
"type": "string",
"enum": [
"lifetime",
"snapshot",
"period",
"unknown"
]
},
"nativePeriod": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "null"
}
]
},
"timezone": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 100
},
{
"type": "null"
}
]
}
},
"required": [
"platform",
"key",
"definition",
"unit",
"grain",
"measurementKind",
"nativePeriod",
"timezone"
],
"additionalProperties": false
},
"value": {
"type": [
"number",
"null"
]
},
"availability": {
"type": "string",
"enum": [
"available",
"partial",
"not_returned",
"unsupported",
"permission_required",
"threshold_not_met",
"no_data",
"failed",
"pending",
"stale"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 8000
},
{
"type": "null"
}
]
},
"measurement": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"lifetime",
"snapshot",
"period",
"unknown"
]
},
"period": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "null"
}
]
},
"start": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "null"
}
]
},
"end": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "null"
}
]
},
"timezone": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 100
},
{
"type": "null"
}
]
}
},
"required": [
"kind",
"period",
"start",
"end",
"timezone"
],
"additionalProperties": false
},
"requestId": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
{
"type": "null"
}
]
},
"sourcePath": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"accountId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"providerResourceId": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 512
},
{
"type": "null"
}
]
},
"fetchedAt": {
"anyOf": [
{
"type": "string",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
"format": "date-time"
},
{
"type": "null"
}
]
},
"identifier": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]{0,63}$"
},
"included": {
"type": "boolean"
}
},
"required": [
"inputId",
"selector",
"value",
"availability",
"reason",
"measurement",
"requestId",
"sourcePath",
"accountId",
"providerResourceId",
"fetchedAt",
"identifier",
"included"
],
"additionalProperties": false
}
}
},
"required": [
"contractVersion",
"workspaceId",
"datasetId",
"formulaId",
"name",
"version",
"expression",
"rounding",
"value",
"unit",
"status",
"code",
"reason",
"excludedInputIds",
"inputs"
],
"additionalProperties": false
}
},
"required": [
"id",
"name",
"version",
"expression",
"definition",
"unit",
"grain",
"rounding",
"inputs",
"value",
"availability",
"reason"
],
"additionalProperties": false
}
}
},
"required": [
"contractVersion",
"id",
"reviewedAt",
"selection",
"accounts",
"posts",
"sources",
"coverage",
"customMetrics"
],
"additionalProperties": false
},
"excluded_input_ids": {
"maxItems": 5000,
"type": "array",
"items": {
"type": "string",
"maxLength": 4000
}
},
"expected_version": {
"anyOf": [
{
"type": "integer",
"minimum": 1,
"maximum": 1000000
},
{
"type": "null"
}
]
},
"mutation_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"calculation": {
"type": "object",
"properties": {
"contractVersion": {
"type": "string",
"const": "analytics-metric/v1"
},
"workspaceId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"datasetId": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"formulaId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"version": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"expression": {
"type": "string",
"maxLength": 1000
},
"rounding": {
"type": "object",
"properties": {
"decimalPlaces": {
"type": "integer",
"minimum": 0,
"maximum": 8
},
"mode": {
"type": "string",
"const": "half_away_from_zero"
}
},
"required": [
"decimalPlaces",
"mode"
],
"additionalProperties": false
},
"value": {
"type": [
"number",
"null"
]
},
"unit": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"status": {
"type": "string",
"enum": [
"available",
"not_returned"
]
},
"code": {
"type": "string",
"enum": [
"ok",
"invalid_expression",
"missing_input",
"incompatible_input",
"zero_denominator",
"numeric_limit",
"workspace_mismatch",
"ambiguous_input",
"unknown_exclusion"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 500
},
{
"type": "null"
}
]
},
"excludedInputIds": {
"maxItems": 5000,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 1500
}
},
"inputs": {
"maxItems": 5000,
"type": "array",
"items": {
"type": "object",
"properties": {
"inputId": {
"type": "string",
"minLength": 1,
"maxLength": 1500
},
"selector": {
"type": "object",
"properties": {
"platform": {
"type": "string",
"enum": [
"facebook",
"instagram",
"threads",
"youtube"
]
},
"key": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_]{0,100}$"
},
"definition": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"unit": {
"type": "string",
"enum": [
"count",
"seconds",
"minutes",
"percent",
"ratio"
]
},
"grain": {
"type": "string",
"enum": [
"post",
"account"
]
},
"measurementKind": {
"type": "string",
"enum": [
"lifetime",
"snapshot",
"period",
"unknown"
]
},
"nativePeriod": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "null"
}
]
},
"timezone": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 100
},
{
"type": "null"
}
]
}
},
"required": [
"platform",
"key",
"definition",
"unit",
"grain",
"measurementKind",
"nativePeriod",
"timezone"
],
"additionalProperties": false
},
"value": {
"type": [
"number",
"null"
]
},
"availability": {
"type": "string",
"enum": [
"available",
"partial",
"not_returned",
"unsupported",
"permission_required",
"threshold_not_met",
"no_data",
"failed",
"pending",
"stale"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 8000
},
{
"type": "null"
}
]
},
"measurement": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"lifetime",
"snapshot",
"period",
"unknown"
]
},
"period": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "null"
}
]
},
"start": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "null"
}
]
},
"end": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "null"
}
]
},
"timezone": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 100
},
{
"type": "null"
}
]
}
},
"required": [
"kind",
"period",
"start",
"end",
"timezone"
],
"additionalProperties": false
},
"requestId": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
{
"type": "null"
}
]
},
"sourcePath": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"accountId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"providerResourceId": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 512
},
{
"type": "null"
}
]
},
"fetchedAt": {
"anyOf": [
{
"type": "string",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
"format": "date-time"
},
{
"type": "null"
}
]
},
"identifier": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]{0,63}$"
},
"included": {
"type": "boolean"
}
},
"required": [
"inputId",
"selector",
"value",
"availability",
"reason",
"measurement",
"requestId",
"sourcePath",
"accountId",
"providerResourceId",
"fetchedAt",
"identifier",
"included"
],
"additionalProperties": false
}
}
},
"required": [
"contractVersion",
"workspaceId",
"datasetId",
"formulaId",
"name",
"version",
"expression",
"rounding",
"value",
"unit",
"status",
"code",
"reason",
"excludedInputIds",
"inputs"
],
"additionalProperties": false
}
},
"required": [
"workspace_id",
"formula",
"dataset",
"expected_version",
"mutation_id"
],
"additionalProperties": false
}Svar och slutförande
HTTP-status vid framgång: 200. När åtgärden är klar: synchronous_http_response.
Ett lyckat HTTP-svar kan betyda att en begäran accepterats snarare än slutförts. Spara returnerat ID för bakgrundsarbete och kontrollera samma åtgärd tills den är klar. Ett schemalagt eller accepterat inlägg är publicerat först när plattformen bekräftar det; en klienttimeout fastställer inte resultatet.
Obligatoriskt betyder obligatoriskt inom sitt överordnade objekt och vald gren. Ett obligatoriskt underfält gör inte ett valfritt överordnat objekt obligatoriskt. Regler och fältnamn nedan kopieras från kontraktet.
| Fält / gren | Typ / obligatoriskt | Begränsningar |
|---|---|---|
$ | objectObligatoriskt i överordnat objekt | — |
definition | objectObligatoriskt i överordnat objekt | — |
definition.id | stringObligatoriskt i överordnat objekt |
|
definition.kind | stringObligatoriskt i överordnat objekt |
|
definition.workspace_id | stringObligatoriskt i överordnat objekt |
|
definition.definition_id | stringObligatoriskt i överordnat objekt |
|
definition.version | integerObligatoriskt i överordnat objekt |
|
definition.name | stringObligatoriskt i överordnat objekt |
|
definition.payload | objectObligatoriskt i överordnat objekt |
|
definition.payload.* | any JSON valueValfritt / objekt | — |
definition.source_object_key | string | nullObligatoriskt i överordnat objekt | — |
definition.source_sha256 | string | nullObligatoriskt i överordnat objekt | — |
definition.created_at | stringObligatoriskt i överordnat objekt |
|
definition.archived | booleanObligatoriskt i överordnat objekt | — |
replayed | booleanObligatoriskt i överordnat objekt | — |
Fullständigt JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"definition": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"kind": {
"type": "string",
"enum": [
"metric",
"template"
]
},
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"definition_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"version": {
"type": "integer",
"minimum": 1,
"maximum": 1000000
},
"name": {
"type": "string",
"maxLength": 100
},
"payload": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"source_object_key": {
"type": [
"string",
"null"
]
},
"source_sha256": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": "string",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
"format": "date-time"
},
"archived": {
"type": "boolean"
}
},
"required": [
"id",
"kind",
"workspace_id",
"definition_id",
"version",
"name",
"payload",
"source_object_key",
"source_sha256",
"created_at",
"archived"
]
},
"replayed": {
"type": "boolean"
}
},
"required": [
"definition",
"replayed"
]
}Fel och säkra nya försök
Kontrollera HTTP-status och svarskropp. Ett valideringsfel med 400 kan innehålla ZodError; hanterarfel använder fälten error, message och code. Spara request_id eller x-request-id för felsökning, utan inloggningsuppgifter. Åtgärda åtkomstfel med 401/403 innan du försöker igen och följ Retry-After vid 429. Om en skrivning är osäker eller returnerar 5xx, läs först det befintliga resultatet. Återanvänd en idempotensnyckel endast där det stöds; försöksbeteendet varierar mellan åtgärder och garanterar inte leverans exakt en gång.
FelsökningsguideExempel
Exemplen använder fiktiva värden som kontrollerats mot schemana. Ersätt ID:n med sådana du får använda, medier med färdiga mediefiler och datum med din bekräftade publiceringstid. Kontrollera kontots behörighet före en skrivning. Denna sida skickar inga API-anrop.
Sätt SOSOAPI_ACCESS_TOKEN på servern till en autentiseringsuppgift som åtgärden godtar och håll den borta från webbläsarkod. För en agent använder du sosoapi auth login för att logga in via webbläsaren och låter CLI förnya sina uppgifter.
request.json
{
"workspace_id": "11111111-1111-4111-8111-111111111111",
"formula": {
"contractVersion": "analytics-metric/v1",
"id": "11111111-1111-4111-8111-111111111111",
"workspaceId": "11111111-1111-4111-8111-111111111111",
"name": "example",
"version": 1,
"expression": "example",
"fields": [],
"rounding": {
"decimalPlaces": 0,
"mode": "half_away_from_zero"
}
},
"dataset": {
"contractVersion": "analytics-report/v1",
"id": "11111111-1111-4111-8111-111111111111",
"reviewedAt": "2099-01-15T09:00:00Z",
"selection": {
"workspaceId": "11111111-1111-4111-8111-111111111111",
"accountIds": [
"11111111-1111-4111-8111-111111111111"
],
"platforms": [
"facebook"
],
"startDate": "2099-01-15",
"endDate": "2099-01-15",
"timezone": "UTC"
},
"accounts": [
{
"id": "11111111-1111-4111-8111-111111111111",
"workspaceId": "11111111-1111-4111-8111-111111111111",
"platform": "facebook",
"name": "Fictional report account"
}
],
"posts": [],
"sources": [],
"coverage": {
"population": "discovered_posts",
"postsComplete": false,
"nextCursor": null,
"postLimit": 0,
"postInsightsLimit": 0,
"omittedPostInsights": 0,
"notes": []
},
"customMetrics": []
},
"expected_version": null,
"mutation_id": "11111111-1111-4111-8111-111111111111"
}cURL
curl --request POST \
"https://gqeshlawtcexsapabaui.supabase.co/functions/v1/analytics-api/reporting/metrics/save" \
-H "Authorization: Bearer $SOSOAPI_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
--data-binary @request.jsonJavaScript
// Server-side JavaScript. Do not print tokens or credential-bearing responses.
const token = process.env.SOSOAPI_ACCESS_TOKEN;
if (!token) throw new Error("Set an accepted credential for this operation");
const response = await fetch("https://gqeshlawtcexsapabaui.supabase.co/functions/v1/analytics-api/reporting/metrics/save", {
method: "POST",
headers: { "Content-Type": "application/json", Authorization: "Bearer " + token },
body: JSON.stringify({
"workspace_id": "11111111-1111-4111-8111-111111111111",
"formula": {
"contractVersion": "analytics-metric/v1",
"id": "11111111-1111-4111-8111-111111111111",
"workspaceId": "11111111-1111-4111-8111-111111111111",
"name": "example",
"version": 1,
"expression": "example",
"fields": [],
"rounding": {
"decimalPlaces": 0,
"mode": "half_away_from_zero"
}
},
"dataset": {
"contractVersion": "analytics-report/v1",
"id": "11111111-1111-4111-8111-111111111111",
"reviewedAt": "2099-01-15T09:00:00Z",
"selection": {
"workspaceId": "11111111-1111-4111-8111-111111111111",
"accountIds": [
"11111111-1111-4111-8111-111111111111"
],
"platforms": [
"facebook"
],
"startDate": "2099-01-15",
"endDate": "2099-01-15",
"timezone": "UTC"
},
"accounts": [
{
"id": "11111111-1111-4111-8111-111111111111",
"workspaceId": "11111111-1111-4111-8111-111111111111",
"platform": "facebook",
"name": "Fictional report account"
}
],
"posts": [],
"sources": [],
"coverage": {
"population": "discovered_posts",
"postsComplete": false,
"nextCursor": null,
"postLimit": 0,
"postInsightsLimit": 0,
"omittedPostInsights": 0,
"notes": []
},
"customMetrics": []
},
"expected_version": null,
"mutation_id": "11111111-1111-4111-8111-111111111111"
})
});
const result = await response.json();
// Check response.ok, the operation-specific body and completion state before continuing.CLI
npx sosoapi api post /analytics-api/reporting/metrics/save < request.jsonSyntetiskt svarsexempel
{
"definition": {
"id": "11111111-1111-4111-8111-111111111111",
"kind": "metric",
"workspace_id": "11111111-1111-4111-8111-111111111111",
"definition_id": "11111111-1111-4111-8111-111111111111",
"version": 1,
"name": "example",
"payload": {},
"source_object_key": "example",
"source_sha256": "example",
"created_at": "2099-01-15T09:00:00Z",
"archived": false
},
"replayed": false
}