AdsApp

Dies ist das Objekt der obersten Ebene, das für den Zugriff auf und die Verwaltung eines einzelnen Kontos verwendet wird.

Hinweis

Dieses Objekt ersetzt das BingAdsApp-Objekt . In der unmittelbaren Zukunft wird Skripts bingAdsApp aus Gründen der Abwärtskompatibilität weiterhin unterstützen. Es wird jedoch empfohlen, Ihre Skripts so zu aktualisieren, dass dieses Objekt so früh wie möglich verwendet wird.

Methoden

Methodenname	Rückgabetyp	Beschreibung
adGroups	AdGroupSelector	Ruft einen Selektor ab, der zum Filtern der Liste der Anzeigengruppen in diesem Konto verwendet wird.
Anzeigen	AdSelector	Ruft einen Selektor ab, der zum Filtern der Liste der Anzeigen in diesem Konto verwendet wird.
Budgets	BudgetSelector	Ruft einen Selektor ab, der zum Filtern der Liste der freigegebenen Budgets in diesem Konto verwendet wird.
Kampagnen	CampaignSelector	Ruft einen Selektor ab, der zum Filtern der Liste der Kampagnen in diesem Konto verwendet wird.
createLabel(string name, string description, string backgroundColor)	void	Erstellt eine Beschriftung.
currentAccount	Account	Ruft das Konto ab, das das Skript derzeit verarbeitet.
getExecutionInfo	ExecutionInfo	Gibt Informationen zu der Umgebung zurück, in der das Skript derzeit ausgeführt wird.
Schlüsselwörter	KeywordSelector	Ruft einen Selektor ab, der zum Filtern der Liste der Schlüsselwörter in diesem Konto verwendet wird.
Etiketten	LabelSelector	Ruft einen Selektor ab, der zum Filtern der Liste der Bezeichnungen in diesem Konto verwendet wird.
negativeKeywordLists	NegativeKeywordListSelector	Ruft einen Selektor ab, der zum Filtern der Liste der negativen Schlüsselwort (keyword) Listen in diesem Konto verwendet wird.
newNegativeKeywordListBuilder	NegativeKeywordListBuilder	Ruft einen Generator ab, der verwendet wird, um diesem Konto eine negative Schlüsselwort (keyword) Liste hinzuzufügen.
Produktgruppen	ProductGroupSelector	Ruft einen Selektor ab, der zum Filtern der Liste der Produktgruppen in diesem Konto verwendet wird.
shoppingAdGroups	AdGroupSelector	Ruft einen Selektor ab, der zum Filtern der Liste der Anzeigengruppen verwendet wird, die für den Einkauf in diesem Konto verwendet werden.
shoppingCampaigns	CampaignSelector	Ruft einen Selektor ab, der zum Filtern der Liste der Kampagnen verwendet wird, die für das Einkaufen in diesem Konto verwendet werden.
userLists	UserListSelector	Ruft einen Selektor ab, der zum Filtern der Liste der Benutzerlisten in diesem Konto verwendet wird.

adGroups

Ruft einen Selektor ab, der zum Filtern der Liste der Anzeigengruppen in diesem Konto verwendet wird.

Rückgabewerte

Typ	Beschreibung
AdGroupSelector	Eine Auswahl, die zum Filtern der Liste der Anzeigengruppen im aktuellen Konto verwendet wird.

Anzeigen

Ruft einen Selektor ab, der zum Filtern der Liste der Anzeigen in diesem Konto verwendet wird.

Rückgabewerte

Typ	Beschreibung
AdSelector	Eine Auswahl, die zum Filtern der Liste der Anzeigen im aktuellen Konto verwendet wird.

Budgets

Ruft einen Selektor ab, der zum Filtern der Liste der freigegebenen Budgets in diesem Konto verwendet wird.

Diese Methode gibt nur freigegebene Budgets zurück. Um nicht freigegebene Budgets (einzelne Kampagnen) zu erhalten, rufen Sie die getBudget-Methode der jeweiligen Kampagne auf. Das Budget der Kampagne wird nicht freigegeben, wenn die isExplicitlyShared Methode false zurückgibt.

Rückgabewerte

Typ	Beschreibung
BudgetSelector	Ein Selektor, der zum Filtern der Liste der freigegebenen Budgets im aktuellen Konto verwendet wird.

Kampagnen

Ruft einen Selektor ab, der zum Filtern der Liste der Kampagnen in diesem Konto verwendet wird.

Rückgabewerte

Typ	Beschreibung
CampaignSelector	Ein Selektor, der zum Filtern der Liste der Kampagnen im aktuellen Konto verwendet wird.

createLabel(string name, string description, string backgroundColor)

Erstellt eine Beschriftung.

Informationen zu den Grenzwerten für die Anzahl von Bezeichnungen, die Sie pro Konto erstellen können, finden Sie unter Grenzwerte. Ein Beispiel, in dem einem Konto eine Bezeichnung hinzugefügt wird, finden Sie unter Verwenden von Bezeichnungen.

Argumente

Name	Typ	Beschreibung
Backgroundcolor	string	Optional. Die Hintergrundfarbe, die in der Benutzeroberfläche für die Bezeichnung verwendet werden soll. Sie können die Farbe mit folgendem Namen angeben: Eine drei-Byte-Hexadezimalzahl im Formular, #RRGGBB. Beispiel: #CB0400. Einer der 16 bekannten CSS-Farbnamen. Zum Beispiel aqua, yellow und fuchsia. Berücksichtigen Sie die Zugriffsfähigkeit bei der Auswahl der Farbe. Wenn nicht angegeben, wird eine zufällige Farbe für Sie ausgewählt.
description	string	Optional. Eine Beschreibung, die die Verwendung der Bezeichnung beschreibt. Die maximale Größe beträgt 200 Zeichen. Wenn Sie angeben backgroundColor, müssen Sie eine Beschreibung oder eine leere Zeichenfolge ("") angeben.
name	string	Erforderlich. Der Name der Bezeichnung. Bei dem Namen wird die Groß-/Kleinschreibung beachtet und muss innerhalb des Kontos eindeutig sein. Die maximale Größe beträgt 80 Zeichen. Die Methode entfernt führende und nachfolgende Leerzeichen aus dem Namen.

Rückgabewerte

Typ	Beschreibung
void	Gibt Nothing zurück.

currentAccount

Ruft das Konto ab, das das Skript derzeit verarbeitet.

Hinweis

Um diese Methode in einem Szenario mit mehreren Konten zu verwenden, wählen Sie zunächst ein Zu verwaltende Konto aus. Wenn Sie diese Methode aufrufen, bevor Sie ein Konto auswählen, gibt der Aufruf NULL zurück.

Rückgabewerte

Typ	Beschreibung
Account	Das Konto, das das Skript derzeit verarbeitet. Informationen zur Verwendung in einem Szenario mit mehreren Konten finden Sie in der Select-Methode von AccountsApp.

getExecutionInfo

Gibt Informationen zu der Umgebung zurück, in der das Skript derzeit ausgeführt wird.

Rückgabewerte:

Typ	Beschreibung
ExecutionInfo	Informationen zur Umgebung, in der das Skript derzeit ausgeführt wird.

"keywords"

Ruft einen Selektor ab, der zum Filtern der Liste der Schlüsselwörter in diesem Konto verwendet wird.

Rückgabewerte

Typ	Beschreibung
KeywordSelector	Ein Selektor, der zum Filtern der Liste der Schlüsselwörter im aktuellen Konto verwendet wird.

Etiketten

Ruft einen Selektor ab, der zum Filtern der Liste der Bezeichnungen in diesem Konto verwendet wird.

Rückgabewerte

Typ	Beschreibung
LabelSelector	Ein Selektor, der zum Filtern der Liste der Bezeichnungen im aktuellen Konto verwendet wird.

negativeKeywordLists

Ruft einen Selektor ab, der zum Filtern der Liste der negativen Schlüsselwort (keyword) Listen in diesem Konto verwendet wird.

Rückgabewerte

Typ	Beschreibung
NegativeKeywordListSelector	Ein Selektor, der zum Filtern der Liste der negativen Schlüsselwort (keyword) Listen im aktuellen Konto verwendet wird.

newNegativeKeywordListBuilder

Ruft einen Generator ab, der verwendet wird, um diesem Konto eine negative Schlüsselwort (keyword) Liste hinzuzufügen.

Rückgabewerte

Typ	Beschreibung
NegativeKeywordListBuilder	Ein Generator, der verwendet wird, um dem aktuellen Konto eine negative Schlüsselwort (keyword) Liste hinzuzufügen.

Produktgruppen

Ruft einen Selektor ab, der zum Filtern der Liste der Produktgruppen in diesem Konto verwendet wird.

Rückgabewerte

Typ	Beschreibung
ProductGroupSelector	Ein Selektor, der zum Filtern der Liste der Produktgruppen im aktuellen Konto verwendet wird.

shoppingAdGroups

Ruft einen Selektor ab, der zum Filtern der Liste der Anzeigengruppen verwendet wird, die für den Einkauf in diesem Konto verwendet werden.

Rückgabewerte

Typ	Beschreibung
AdGroupSelector	Eine Auswahl, die zum Filtern der Liste der Anzeigengruppen verwendet wird, die für den Einkauf im aktuellen Konto verwendet werden.

shoppingCampaigns

Ruft einen Selektor ab, der zum Filtern der Liste der Kampagnen verwendet wird, die für das Einkaufen in diesem Konto verwendet werden.

Rückgabewerte

Typ	Beschreibung
CampaignSelector	Eine Auswahl, die zum Filtern der Liste der Kampagnen verwendet wird, die zum Einkaufen im aktuellen Konto verwendet werden.

userLists

Ruft einen Selektor ab, der zum Filtern der Liste der Benutzerlisten in diesem Konto verwendet wird.

Rückgabewerte

Typ	Beschreibung
UserListSelector	Ein Selektor, der zum Filtern der Liste der Benutzerlisten im aktuellen Konto verwendet wird.

Siehe auch

Zugriff auf ein einzelnes Konto