API v1.11.0

Kapitel 06 von 07

Zeitplan und Autopilot

Verifizierung und Launch (Kapitel 2) kann der Betreiber von Hand für Sie einreichen. Für Mandanten, die regelmäßig neue Agents anlegen, gibt es zwei Automatiken: den Autopiloten, der einen vorbereiteten Agent durch Verifizierung und Launch führt, und den Zeitplan, der zusätzlich Tester einlädt und Termine einhält. Dieses Kapitel beschreibt beide und zeigt, wo Sie selbst entscheiden.

Der Autopilot

Der Autopilot wird vom Betreiber je Mandant freigeschaltet. Ist er aktiv, kann Ihr System einen Agent „zur Prüfung einreichen". Danach läuft ohne weiteres Zutun: Verifizierung einreichen, auf das Ergebnis warten, Launch einreichen, auf die Entscheidung der Netzbetreiber warten, und anschließend den laufenden Agent beobachten.

Beim Einreichen prüft der Autopilot zuerst, ob alles vorhanden ist. Der Agent muss im Status DRAFT sein, seine Marke braucht einen vollständigen Verifizierungskontakt und Nachweisdokumente, der Launch-Fragebogen muss vollständig sein, und Ihr Mandant braucht einen aktiven Tarif, dessen Launch-Kontingent noch nicht ausgeschöpft ist. Fehlt etwas, bekommen Sie eine Liste der Mängel und nichts wird eingereicht.

Hinweis: Die Vorprüfung lässt sich auch allein ausführen, als Probelauf ohne Einreichung. So sehen Sie vorab, was noch fehlt, ohne den Autopiloten scharf zu schalten.

Standardmäßig geht der Launch an alle deutschen Netzbetreiber. Für einen kontrollierten Test lässt sich der Launch auf einzelne Netzbetreiber beschränken.

Die eigentliche Arbeit erledigt ein Hintergrundprozess in regelmäßigen Abständen; die Einreichung ist sofort quittiert, die Schritte folgen danach. Den Fortschritt sehen Sie in der Launch-Übersicht des Agents, oder Sie lassen sich jede Änderung an Ihr System melden (siehe unten).

Nach dem Launch bleibt der Autopilot im Zustand „Beobachtung" und fragt den Stand bei Google in größeren Abständen weiter ab, um eine spätere Aussetzung durch einen Netzbetreiber oder einen Rückzug des Launches zu bemerken. Eine Aussetzung ist umkehrbar: Aktiviert der Netzbetreiber den Agent wieder, wechselt der Status zurück auf LAUNCHED und Sie werden erneut benachrichtigt.

Der Drei-Schritt-Zeitplan

Der Zeitplan ergänzt den Autopiloten um Termine und Tester. Der Betreiber richtet ihn mit Ihnen ein, entweder je Agent oder als Vorlage, die für jeden neuen Agent Ihres Mandanten automatisch angelegt wird. Jeder Plan besteht aus denselben drei Schritten:

  1. Tester einladen. Die hinterlegte Liste von Testnummern wird am Agent registriert; die Personen erhalten die Einladung von Google auf ihr Gerät.
  2. Verifizierung einreichen. Optional mit der Bedingung, dass zuvor eine Mindestzahl von Testern die Einladung angenommen hat.
  3. Launch einreichen.

Jeder Schritt hat einen Auslöser: ein fester Zeitpunkt, eine Frist ab Anlage des Plans oder eine Frist nach Abschluss des vorherigen Schritts. Die Reihenfolge ist fest; ein Schritt wird nie vor dem vorherigen ausgeführt.

Einige Regeln, die in der Praxis wichtig sind:

  • Tester sind keine Voraussetzung. Verifizierung und Launch brauchen keine angenommenen Einladungen. Die Bedingung in Schritt 2 ist freiwillig und standardmäßig leer; die Box erfährt nur durch Nachfragen bei Google, ob jemand angenommen hat.
  • Warten vor dem Launch. Zwischen Schritt 2 und 3 steht der Agent im Autopilot-Zustand HOLDING_LAUNCH: Die Verifizierung ist durch, der Launch wartet auf seinen Termin. Nur Schritt 3 oder das Anhalten des Autopiloten beenden diesen Zustand. Wird Schritt 3 übersprungen, gibt es keinen automatischen Launch; der Agent bleibt in Wartestellung, bis der Launch ausgelöst wird.
  • Von außen eingereicht gewinnt. Reicht der Betreiber oder Ihr System die Verifizierung vor dem Termin ein, gilt Schritt 2 als erledigt.
  • „Jetzt ausführen" überspringt Termin und Tester-Bedingung eines Schritts, nie die Reihenfolge.
  • Anhalten und Rückzug pausieren den Plan. Wird der Autopilot gestoppt oder der Agent zurückgezogen, läuft der Zeitplan nicht weiter, bis er wieder aufgenommen wird.
  • Kurz nach der Anlage eines Agents nimmt Google Tester-Einladungen für einen kurzen Moment noch nicht an. Der Zeitplan behandelt das nicht als Fehler, sondern wiederholt Schritt 1 beim nächsten Durchlauf.

Wo Sie eingreifen

Auch mit Automatik bleiben Ihnen die Entscheidungen:

Zeitpunkt Was Sie tun
Vor der Einreichung Fragebogen-Entwurf hinterlegen und aktualisieren (Kapitel 3); jeder neue Entwurf ersetzt den alten, der Autopilot nimmt den jüngsten.
Vor der Einreichung Testnummern registrieren oder vom Zeitplan registrieren lassen; Einladungen auf den Geräten annehmen.
Jederzeit Probelauf der Vorprüfung, um Mängel zu sehen.
Nach Ablehnung Begründung je Netzbetreiber lesen, Fragebogen oder Agent nachbessern, erneut einreichen lassen.
Im Betrieb Agent zurückziehen; der Autopilot wird dabei angehalten, damit er den Launch nicht erneut einreicht.
Bei Bedarf Den Betreiber bitten, den Autopiloten anzuhalten oder fortzusetzen.

Achtung: Eine Entscheidung, die Sie an den Betreiber oder den Autopiloten übergeben haben, lässt sich nicht zurückholen, während Google und die Netzbetreiber sie bearbeiten. Ein eingereichter Launch wird geprüft, auch wenn der Autopilot für den Mandanten zwischenzeitlich abgeschaltet wird.

Statusmeldungen an Ihr System

Bei jedem Wechsel im Ablauf, auch wenn der Betreiber den Autopiloten von Hand anhält oder fortsetzt, sendet die Box eine Meldung an die Adresse in Ihrem System, die auch Antworten empfängt (Kapitel 5). Sie enthält den Zustand des Autopiloten, den Google-Status des Agents, den Einzelstand je Netzbetreiber mit dessen Kommentar und, wenn etwas schiefgegangen ist, eine deutsche Fehlermeldung samt Einordnung: fachlicher Mangel, Ablehnung, wiederholt gescheiterter Versuch, vom Betreiber angehalten, Launch außerhalb der Box zurückgezogen oder Aussetzung durch einen Netzbetreiber. So sieht Ihr Team je Netzbetreiber nicht nur, dass etwas passiert ist, sondern auch, warum.

Technisch nachlesen

  • Launch: Einreichen, Probelauf, Launch-Übersicht, Rückzug
  • Testers: Testnummern und Einladungsstatus
  • Webhooks: Statusmeldung des Autopiloten
  • Carriers: Liste der Netzbetreiber für einen beschränkten Launch

Weiter: Glossar und FAQ →