Durchführen des Upgrades für die neueste Graph API-Version
In diesem Leitfaden erfährst du, wie du deine App auf den Test von verschiedenen Versionen der Graph API vorbereitest und wie du auf ein Upgrade auf die neuste Version durchführst.
Das API-Upgrade-Tool zeigt dir, welche API-Aufrufe deiner App eventuell von Änderungen in neueren Versionen der API betroffen sind. So kannst du auf einen Blick sehen, welche Änderungen du vornehmen musst, um ein Upgrade deiner aktuellen Version zu einer neueren Version durchzuführen.
Erfahre, wie sich eine Änderung auf deine App auswirkt
Das API-Upgrade-Tool zeigt eine angepasste Liste mit Änderungen an, die sich beim Upgrade für eine bestimmte Zielversion auf eine App auswirken. Dies ermöglicht dir, alle relevanten Änderungen zwischen der jeweiligen ursprünglichen und der neuen Version anzuzeigen.
Schritt 1: Wähle im Upgrade-Tool deine App aus dem Dropdown-Menü aus oder gib den Namen der App ein.
Im Dropdown-Menü werden nur maximal zehn Apps aufgeführt. Verwende die Suchleiste im Dropdown-Menü, um mehr Apps anzuzeigen, als aufgeführt werden.
Schritt 2: Wähle mit den Dropdown-Menüs rechts die Version aus, von der du ein Upgrade durchführen möchtest, und die Version, für die das Upgrade durchgeführt werden soll.
Ergebnisse lesen
Das Tool zeigt an, wie viele Änderungen vorgenommen werden müssen, um deine App auf die gewählte Version upzudaten. Wenn deine App API-Aufrufe tätigt, die von einer neueren Version nicht betroffen sind, werden keine Daten zurückgegeben.
Die Methoden sind entsprechend der Version farblich gekennzeichnet. Zeige mit der Maus auf das Balkendiagramm, um die Anzahl der Änderungen in jeder Version anzuzeigen. Die Datumsangaben für jede Version geben an, wann die Änderungen für alle Apps durchgesetzt werden.
Die Tabelle enthält den Typ der Änderung (veraltet, neues Feature oder Änderung), die betroffenen Methoden, die Anzahl der in den letzten 7 Tagen getätigten Aufrufe und den Prozentsatz der API-Aufrufe, der von der jeweiligen Änderung betroffen ist.
Einschränkungen
- Um die App im Tool zu sehen, musst du Administrator oder Entwickler der App sein.
- Es werden keine Daten zurückgegeben, wenn deine App keine oder zu wenige API-Aufrufe aus der Version getätigt hat, von der du aktualisieren möchtest.
- Das Aufruf-Volumen wird möglicherweise falsch angezeigt. Die API-Aufruf-Protokollierung wird für eine Stichprobe herangezogen und über die vorherige Woche zusammengefasst. Sie wird mit dem Aufruf-Volume verglichen, um zu schätzen, wie viele deiner Aufrufe von einer Versionsänderung betroffen sein könnten.
Hinweis: Möglicherweise wirken sich nicht alle Änderungen auf jeden API-Aufruf aus. Du musst selbst einschätzen, ob eine Änderung von deiner App verarbeitet werden muss. Achte darauf, deine API-Aufrufe in der neueren Version zu testen.
Implementieren einer neuen Version
Navigiere im App-Dashboard Einstellungen > Erweitert zum Abschnitt API Version-Upgrade.
Upgrades für Entwickler und Administratoren
Hiermit wird für alle Entwickler und Administratoren einer App ein Upgrade auf die nächste verfügbare Version durchgeführt. Damit kannst du Änderungen mit einer kleinen Gruppe realer Benutzer testen, bevor du die neue Version für alle veröffentlichst.
Upgrades für alle Aufrufe
Hiermit wird bei allen Aufrufen einer App ein Upgrade auf die nächste verfügbare Version durchgeführt. Ein frühzeitiges Upgrade empfiehlt sich, da anfänglich die Option besteht, bei unvorhergesehenen Fehlern oder Problemen zur ursprünglichen Version zurückzukehren.
Mehr dazu
- Änderungsprotokoll für Graph API – Erfahre mehr über die Änderungen in der neuesten Version.
- Versionierung – Erfahre alles für die Graph API-Versionierung, Anfragen für verschiedene Versionen usw.
- Test-Apps – Erfahre, wie du Test-Apps erstellst, um Änderungen an deiner App vor der Veröffentlichung zu testen.
- Testnutzer – Erfahre, wie du Testnutzer erstellst, um Änderungen an deiner App vor der Veröffentlichung zu testen.