Activities: insert

YouTube hat die Funktion für Kanalbulletins eingestellt und diese Methode wird nicht mehr unterstützt.

Weitere Informationen finden Sie in der YouTube-Hilfe.

ein Bulletin für einen bestimmten Kanal posten. (Der Nutzer, der die Anfrage stellt, muss autorisiert sein, im Namen des Kanals zu handeln.)

Hinweis: Auch wenn eine activity-Ressource Informationen zu Aktionen enthalten kann, z. B. wenn ein Nutzer ein Video bewertet oder ein Video als Favorit markiert, müssen Sie andere API-Methoden verwenden, um diese activity-Ressourcen zu generieren. Zum Beispiel würden Sie die Methode videos.rate() der API verwenden, um ein Video zu bewerten, und die Methode playlistItems.insert(), um es als Favorit zu markieren.

Kontingentauswirkung: Ein Aufruf dieser Methode hat Kontingentkosten von 50 Einheiten.

Anfragen

HTTP-Anfrage

POST https://www.googleapis.com/youtube/v3/activities

Autorisierung

Diese Anfrage benötigt eine Autorisierung mit mindestens einem der folgenden Bereiche (weitere Informationen zu Authentifizierung und Autorisierung).

Bereich
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Parameter

In der folgenden Tabelle sind die Parameter aufgeführt, die von dieser Abfrage unterstützt werden. Alle aufgeführten Parameter sind Abfrageparameter.

Parameter
Erforderliche Parameter
part string
Der Parameter part dient in diesem Vorgang zwei Zwecken. Er gibt die Attribute an, die vom Schreibvorgang festgelegt werden, sowie die Eigenschaften, die die API-Antwort enthalten soll.

Die folgende Liste enthält die part-Namen, die du in den Parameterwert aufnehmen kannst:
  • contentDetails
  • id
  • snippet

Anfragetext

Geben Sie im Anfragetext eine Aktivitätsressource an. Für diese Ressource:

  • Sie müssen einen Wert für diese Attribute angeben:

    • snippet.description

  • Sie können Werte für diese Eigenschaften festlegen:

    • snippet.description
    • contentDetails.bulletin.resourceId

Antwort

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine Aktivitätsressource im Antworttext zurückgegeben.

Fehler

In der folgenden Tabelle finden Sie Fehlermeldungen, die die API als Antwort auf einen Aufruf dieser Methode zurückgeben könnte. Weitere Informationen finden Sie in der Dokumentation zu Fehlermeldungen.

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) bulletinTextRequired In der Anfrage muss die Eigenschaft description des snippet-Objekts verwendet werden, um den Text für den Bulletin-Beitrag bereitzustellen.
badRequest (400) invalidMetadata Das Attribut kind entspricht nicht dem angegebenen ID-Typ.
forbidden (403) forbidden Die Anfrage ist nicht ordnungsgemäß autorisiert.
notFound (404) playlistNotFound YouTube kann das Video, das du dem Bulletin zuordnen möchtest, nicht finden. Prüfen Sie den Wert der Eigenschaft contentDetails.bulletinPosted.playlistId.
notFound (404) videoNotFound YouTube kann das Video, das du dem Bulletin zuordnen möchtest, nicht finden. Prüfen Sie den Wert der Eigenschaft contentDetails.bulletinPosted.videoId.
userRateLimitExceeded (403) rateLimitExceeded Die Anfrage kann nicht abgeschlossen werden, da Sie Ihr Kontingent überschritten haben.