Linkgruppenliste

Die Linkgruppen-Listen-API ermöglicht es, alle vom Benutzer erstellten Linkgruppen abzurufen.
Um beim Erstellen eines Links eine bestimmte Gruppe zuzuweisen, rufen Sie zunächst mit dieser API die Liste ab und ermitteln den IDX-Wert der gewünschten Gruppe.
Durch das Einfügen dieses IDX-Werts in die Link-Erstellungsanfrage werden die Einstellungen der Gruppe automatisch auf den Link angewendet, was die Verwaltung effizienter macht.

Http Header
GET /api/link-group/v1/list
Host: https://vivoldi.com
Authorization: APIKey {Your API Key}
Content-type: -
User-agent: {Your User-agent}
Accept-Language: en
Request
{
	"nm": "My group"
}
FelderFeldbeschreibungenBeschreibungErforderlichTyp
grpIdxGruppen-IDX Ruft die Gruppe ab, die genau mit dem angegebenen IDX übereinstimmt. int
nmGruppenname Sucht nach Gruppen, deren Name den angegebenen Text enthält.
Teilweise Übereinstimmungen sind erlaubt; vollständige Übereinstimmung ist nicht erforderlich.
string
 
Response
{
	"code": 0,
	"message": "",
	"result": [
		{
			"idx":1,
			"nm":"Amazon Electronics",
			"memo":"Products between $100 and $500",
			"linkCnt":112,
			"blockOverseasSticsYn":"N",
			"notfSubscYn":"N",
			"kakaoNotifyYn":"N",
			"pushNotifyYn":"N",
			"mailNotifyYn":"N",
			"regYmdt":"2024-07-20 02:30:00",
			"modYmdt":"2024-08-15 17:45:10"
		},
		{
			"idx":2,
			"nm":"XXX Advertiser Group",
			"memo":"2-year contract",
			"linkCnt":68,
			"blockOverseasSticsYn":"N",
			"notfSubscYn":"Y",
			"kakaoNotifyYn":"N",
			"pushNotifyYn":"Y",
			"mailNotifyYn":"N",
			"regYmdt":"2024-07-20 02:42:00",
			"modYmdt":"2025-02-12 11:20:50"
		}
	]
}
FelderBeschreibungTyp
codeAntwortcode (0: Erfolg)int
messageWird angezeigt, wenn der Code ungleich 0 ist. Enthält eine Fehlermeldung mit der Ursache des Fehlers.string
result
FelderFeldbeschreibungenBeschreibungTyp
idxGruppen-IDX-int
nmGruppenname-string
memoNotiz-string
linkCntAnzahl der LinksAnzahl der mit der Gruppe verbundenen Linksint
blockOverseasSticsYnAusländische Statistiken blockierenY: Aktiv, N: InaktivY oder N
notfSubscYnPush-AbonnementY: Aktiv, N: InaktivY oder N
kakaoNotifyYnKakao-KlickbenachrichtigungY: Aktiv, N: InaktivY oder N
pushNotifyYnPush-KlickbenachrichtigungY: Aktiv, N: InaktivY oder N
mailNotifyYnE-Mail-KlickbenachrichtigungY: Aktiv, N: InaktivY oder N
regYmdtErstellungsdatumDatum, an dem die Gruppe erstellt wurdeDate
modYmdtÄnderungsdatumDatum, an dem die Gruppe zuletzt geändert wurdeDate
array