Method: customers.generateShareablePreviews

Gibt die angeforderte Vorschau für die gemeinsame Nutzung zurück.

HTTP-Anfrage

POST https://googleads.googleapis.com/v17/customers/{customerId}:generateShareablePreviews

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customerId

string

Erforderlich. Der Kunde, der die Anfrage zum Teilen der Vorschau erstellt.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "shareablePreviews": [
    {
      object (ShareablePreview)
    }
  ]
}
Felder
shareablePreviews[]

object (ShareablePreview)

Erforderlich. Die Liste der gemeinsam nutzbaren Vorschauen, die erstellt werden sollen.

Antworttext

Antwortnachricht für ShareablePreviewService.GenerateShareablePreviews.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "responses": [
    {
      object (ShareablePreviewOrError)
    }
  ]
}
Felder
responses[]

object (ShareablePreviewOrError)

Liste der generierten Vorschauergebnisse, die freigegeben werden können.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/adwords

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

ShareablePreview

Eine Vorschau, die freigegeben werden kann und die zugehörige ID enthält.

JSON-Darstellung 
{
  "assetGroupIdentifier": {
    object (AssetGroupIdentifier)
  }
}
Felder
assetGroupIdentifier

object (AssetGroupIdentifier)

Erforderlich. Asset-Gruppe der Vorschau, die freigegeben werden kann.

AssetGroupIdentifier

Asset-Gruppe der Vorschau, die freigegeben werden kann.

JSON-Darstellung 
{
  "assetGroupId": string
}
Felder
assetGroupId

string (int64 format)

Erforderlich. Die Asset-Gruppen-ID.

ShareablePreviewOrError

Ergebnis der generierten Vorschau, die freigegeben werden kann.

JSON-Darstellung 
{
  "assetGroupIdentifier": {
    object (AssetGroupIdentifier)
  },

  // Union field generate_shareable_preview_response can be only one of the
  // following:
  "shareablePreviewResult": {
    object (ShareablePreviewResult)
  },
  "partialFailureError": {
    object (Status)
  }
  // End of list of possible types for union field
  // generate_shareable_preview_response.
}
Felder
assetGroupIdentifier

object (AssetGroupIdentifier)

Die Asset-Gruppe der teilbaren Vorschau.
Union-Feld generate_shareable_preview_response. Ergebnis oder Fehler der teilbaren Vorschau. Für generate_shareable_preview_response ist nur einer der folgenden Werte zulässig:
shareablePreviewResult

object (ShareablePreviewResult)

Das Vorschauergebnis, das freigegeben werden kann.
partialFailureError

object (Status)

Fehler bei Teilfehlern der Vorschau zum Teilen.

ShareablePreviewResult

Nachricht für ein teilbares Vorschauergebnis.

JSON-Darstellung 
{
  "shareablePreviewUrl": string,
  "expirationDateTime": string
}
Felder
shareablePreviewUrl

string

Die Vorschau-URL, die freigegeben werden kann.
expirationDateTime

string

Ablaufdatum und -uhrzeit im ISO-8601-Format.