Publishing
Publisher-Nutzung
Wie Ihre veröffentlichten Apps in einem Zeitraum aufgerufen wurden: Totals plus Aufschlüsselungen nach Tag, Stunde, App, Kanal, Status, Version, Fehlercode oder Caller.
GET
Publisher-Nutzung
GET https://api-datahub.octoparse.com/v1/publisher/usage
Authentifizierung: API-Schlüssel erforderlich (Authorization: Bearer <API Key>).
Wie Ihre Apps in einem Zeitraum aufgerufen wurden: Summen für den Bereich sowie Aufschlüsselungen nach Tag (oder Stunde bei kurzen Bereichen), App und Aufrufkanal (zwei davon lassen sich kreuzen) oder diagnostische Aufschlüsselungen nach Endzustand, Version oder Fehlercode. Dies ist das Publisher-seitige Gegenstück zur Abrechnungsaggregation: dasselbe Vokabular (created_from / created_to bezogen auf die Startzeit des Runs, Beginn inklusiv und Ende exklusiv; tz_offset verschiebt nur die Tagesgrenzen; data_app / triggered_by grenzen den Umfang ein), wobei die Zuordnung von „von mir gestartete Runs“ zu „Apps, die mir gehören“ wechselt (einschließlich Apps ohne Release).
Aufschlüsselungen nach Tag / Stunde / App / Kanal stammen aus Stunden-Buckets, die beim Erreichen des Endzustands aufsummiert werden, sodass jeder Bereich und jeder volle Stunden-Offset exakt und günstig bleibt. Aufschlüsselungen nach Status / Version / Fehler werden bei Bedarf aus den Run-Details berechnet; daher sind beide Grenzen erforderlich und der Zeitraum darf höchstens 92 Tage umfassen (400 range-too-wide). Fehlergruppen umfassen nur Runs mit einem Fehler; jede Gruppe enthält die neueste Fehlermeldung als sample_message. Debug-Runs des Autors sind standardmäßig ausgeschlossen; Health-Probes der Plattform zählen nie. Erfolg schließt Teilerfolg ein; abgebrochene Runs bleiben aus dem Nenner der Erfolgsquote heraus; Kennzahlen ohne beendete Runs sind null. amount ist die Datengebühr, die Aufrufer für diese Runs bezahlt haben, nicht der abgerechnete Umsatz des Publishers.
Tages- und Stundengruppen sind aufsteigend sortiert (hour-Schlüssel sind lokale Uhrzeiten YYYY-MM-DDTHH:00 unter tz_offset, ohne Zeitzonensuffix). Andere Gruppen sind absteigend nach Anzahl der Runs sortiert. Unbekannte oder fremde Apps in data_app liefern 404.
totals.callers ist die Anzahl eindeutiger aufrufender Benutzer im Bereich, ermittelt aus den Run-Details, und wird nur gesetzt, wenn der Bereich begrenzt ist und höchstens 92 Tage umfasst. group_by=caller schlüsselt eine einzelne private oder geteilte App nach Aufrufer auf: Der Autor (caller_kind=owner) und Benutzer, die aktuell auf der Grant-Liste stehen (grantee), erscheinen unter ihrem aktuellen Benutzernamen; alle anderen (ehemalige Grantees, Aufrufer aus einer öffentlichen Phase) werden in einer Gruppe other zusammengefasst. Öffentliche Apps oder mehrere Apps liefern 400 caller-group-unavailable: Aufrufer öffentlicher Apps bleiben anonym und werden nur gezählt.
Anfrage
Abfrageparameter
string
Standard:"day"
Eine oder zwei Dimensionen, durch Kommas getrennt:
day / hour / data_app / triggered_by / state / version / error / caller (zum Beispiel day,data_app). day und hour lassen sich nicht kombinieren; state / version / error / caller benötigen einen begrenzten Bereich von höchstens 92 Tagen; caller erfordert außerdem genau eine private oder geteilte App. Standard ist day.string[]
Auf diese Apps beschränken (
<username>/<app_name>, wiederholbar). Standard: alle Ihre Apps.string
Inklusiver Start.
string
Exklusives Ende.
integer
Standard:"0"
Zeitzonen-Offset in Minuten für Tages- und Stunden-Buckets. Verwenden Sie
480 für China Standard Time. Buckets haben Stundengranularität; Offsets mit halben Stunden werden auf die volle Stunde gerundet.Bereich -720 bis 840.string
Auf einen Aufrufkanal beschränken (
api / sdk / mcp / web usw.).boolean
Standard:"False"
Ob Autor-Debug-Runs einbezogen werden.
boolean
Standard:"False"
Liefert zusätzlich
previous_totals für das gleich lange Zeitfenster unmittelbar vor created_from. Erfordert beide Grenzen.Beispielanfrage
Antwort
200 Erfolg
data gewrappt. Felder:
object
erforderlich
Der tatsächlich verwendete Bereich und Offset.
string
Währung.
object
erforderlich
Summen für den Bereich.
object
Summen des gleich langen vorherigen Zeitfensters bei
compare=true.string
Tatsächlich verwendete Dimension(en).
object[]
Gruppenzeilen. Jede Zeile enthält dieselben Kennzahlen wie
totals plus Dimensionsschlüssel (day / hour / namespace + app_name / channel / state / version / error_code + error_category + sample_message + last_seen_at / username + caller_kind). Nicht verwendete Schlüssel sind null.Fehler
Fehlerantworten nutzen
{"error": {code, category, message, retryable}}. Siehe Fehler.