adloop 0.34.0__tar.gz → 0.34.1__tar.gz

{adloop-0.34.0 → adloop-0.34.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: adloop
-Version: 0.34.0
+Version: 0.34.1
 Summary: The AI command center for Google Ads, Reddit Ads, GA4, and tracking code.
 Keywords: mcp,google-ads,reddit-ads,google-analytics,ga4,cursor,marketing
 Author: Daniel Klose

{adloop-0.34.0 → adloop-0.34.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "adloop"
-version = "0.34.0"
+version = "0.34.1"
 description = "The AI command center for Google Ads, Reddit Ads, GA4, and tracking code."
 readme = "README.md"
 requires-python = ">=3.11"

{adloop-0.34.0 → adloop-0.34.1}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "adloop"
-version = "0.34.0"
+version = "0.34.1"
 description = "The AI command center for Google Ads, Reddit Ads, GA4, and tracking code."
 readme = "README.md"
 authors = [

{adloop-0.34.0 → adloop-0.34.1}/src/adloop/ads/assets.py

@@ -151,8 +151,22 @@ def _validate_callout_texts(callouts: list[str]) -> tuple[list[str], list[str]]:
     return validated, errors
 
 
-def _validate_snippet_items(snippets: list[dict]) -> tuple[list[dict], list[str]]:
-    from adloop.ads.write import _STRUCTURED_SNIPPET_HEADERS
+def _header_error(index: int, header: str) -> str:
+    from adloop.ads.snippet_headers import ENGLISH_HEADERS
+
+    return (
+        f"Structured snippet {index + 1}: header '{header}' is not one of Google's snippet "
+        f"headers. English: {', '.join(ENGLISH_HEADERS)}. Google's translations are "
+        "accepted too, in the language of the values (German 'Typen', 'Marken', "
+        "'Dienstleistungen'): https://developers.google.com/google-ads/api/data/structured-snippet-headers"
+    )
+
+
+def _validate_snippet_items(
+    snippets: list[dict], *, keep_header: str = ""
+) -> tuple[list[dict], list[str]]:
+    """Check snippets; ``keep_header`` is an existing asset's header, accepted as is."""
+    from adloop.ads.snippet_headers import canonical_header
 
     errors: list[str] = []
     validated: list[dict] = []
@@ -161,11 +175,12 @@ def _validate_snippet_items(snippets: list[dict]) -> tuple[list[dict], list[str]
     for index, snippet in enumerate(snippets):
         header = _clean(snippet.get("header", ""))
         values = [_clean(value) for value in snippet.get("values", []) or []]
-        if header not in _STRUCTURED_SNIPPET_HEADERS:
-            errors.append(
-                f"Structured snippet {index + 1}: header must be one of "
-                f"{sorted(_STRUCTURED_SNIPPET_HEADERS)}"
-            )
+        if keep_header and header == keep_header:
+            pass  # Google already holds this header; it is not ours to reject.
+        elif canonical := canonical_header(header):
+            header = canonical
+        else:
+            errors.append(_header_error(index, header))
         if len(values) < 3 or len(values) > 10:
             errors.append(f"Structured snippet {index + 1}: values must contain 3-10 items")
         for value_index, value in enumerate(values):
@@ -543,9 +558,11 @@ def update_structured_snippet(
         current, error = _asset_for_edit(config, customer_id, asset_id, _SNIPPET_FIELDS, "STRUCTURED_SNIPPET")
         if error:
             return error
-    # An empty header keeps the current one; values are always the full list.
-    snippet = {"header": _clean(header) or (current or {}).get("header", ""), "values": values or []}
-    validated, snippet_errors = _validate_snippet_items([snippet])
+    # An empty header keeps the current one, accepted as Google stores it;
+    # values are always the full list.
+    kept = (current or {}).get("header", "")
+    snippet = {"header": _clean(header) or kept, "values": values or []}
+    validated, snippet_errors = _validate_snippet_items([snippet], keep_header=kept)
     errors.extend(snippet_errors)
     if errors:
         return {"error": "Validation failed", "details": errors}

adloop-0.34.1/src/adloop/ads/snippet_headers.py

@@ -0,0 +1,723 @@
+"""Structured snippet headers Google accepts: the English names and their translations.
+
+A snippet header has to be one of these strings, in the language of the
+snippet's values. Generated from Google's table "Structured Snippet Header
+Translations":
+https://developers.google.com/google-ads/api/data/structured-snippet-headers
+"""
+
+from __future__ import annotations
+
+# The English headers, in the column order of the table below.
+ENGLISH_HEADERS = (
+    "Brands",
+    "Amenities",
+    "Styles",
+    "Types",
+    "Destinations",
+    "Services",
+    "Courses",
+    "Neighborhoods",
+    "Shows",
+    "Insurance coverage",
+    "Degree programs",
+    "Featured Hotels",
+    "Models",
+)
+
+# locale -> (language, headers in ENGLISH_HEADERS order; "" where Google lists none).
+LOCALIZED_HEADERS: dict[str, tuple[str, tuple[str, ...]]] = {
+    "ar": ("Arabic", (
+        'العلامات التجارية',
+        'وسائل الراحة',
+        'الأنماط',
+        'الأنواع',
+        'الوجهات',
+        'الخدمات',
+        'الدورات التدريبية',
+        'الأحياء',
+        'العروض',
+        'التغطية التأمينية',
+        'برامج الشهادات',
+        'الفنادق المميّزة',
+        'النماذج',
+    )),
+    "bg": ("Bulgarian", (
+        'Марки',
+        'Удобства',
+        'Стилове',
+        'Типове',
+        'Дестинации',
+        'Услуги',
+        'Курсове',
+        'Квартали',
+        'Предавания',
+        'Застраховка',
+        'Специалности',
+        'Представени хотели',
+        'Модели',
+    )),
+    "ca": ("Catalan", (
+        'Marques',
+        'Serveis addicionals',
+        'Estils',
+        'Tipus',
+        'Destinacions',
+        'Serveis',
+        'Cursos',
+        'Barris',
+        'Programes',
+        'Assegurança',
+        'Titulacions',
+        'Hotels destacats',
+        'Models',
+    )),
+    "zh-HK": ("Chinese (Hong Kong)", (
+        '品牌',
+        '設施',
+        '款式',
+        '類型',
+        '目的地',
+        '服務',
+        '課程',
+        '社區',
+        '節目',
+        '保障範圍',
+        '學位課程',
+        '特色酒店',
+        '型號',
+    )),
+    "zh-CN": ("Chinese (Simplified)", (
+        '品牌',
+        '设施',
+        '款式',
+        '类型',
+        '目的地',
+        '服务',
+        '课程',
+        '社区',
+        '节目',
+        '险种',
+        '学位课程',
+        '精选酒店',
+        '型号',
+    )),
+    "zh-TW": ("Chinese (Traditional)", (
+        '品牌',
+        '設施',
+        '款式',
+        '類型',
+        '目的地',
+        '服務',
+        '課程',
+        '社區',
+        '節目',
+        '承保範圍',
+        '學位課程',
+        '精選飯店',
+        '型號',
+    )),
+    "hr": ("Croatian", (
+        'Robne marke',
+        'Sadržaji',
+        'Stilovi',
+        'Vrste',
+        'Odredišta',
+        'Usluge',
+        'Tečajevi',
+        'Četvrti',
+        'Emisije',
+        'Osiguranje',
+        'Studijski programi',
+        'Istaknuti hoteli',
+        'Modeli',
+    )),
+    "cs": ("Czech", (
+        'Značky',
+        'Vybavení',
+        'Styly',
+        'Typy',
+        'Cíle',
+        'Služby',
+        'Kurzy',
+        'Známé oblasti',
+        'Pořady',
+        'Pojištění',
+        'Studijní programy',
+        'Vybrané hotely',
+        'Modely',
+    )),
+    "da": ("Danish", (
+        'Brands',
+        'Faciliteter',
+        'Design',
+        'Typer',
+        'Destinationer',
+        'Tjenester',
+        'Kurser',
+        'Nabolag',
+        'Serier',
+        'Forsikringsdækning',
+        'Uddannelser',
+        'Udvalgte hoteller',
+        'Modeller',
+    )),
+    "nl": ("Dutch", (
+        'Merken',
+        'Voorzieningen',
+        'Stijlen',
+        'Typen',
+        'Bestemmingen',
+        'Services',
+        'Cursussen',
+        'Buurten',
+        'Shows',
+        'Dekking',
+        "Studieprogramma's",
+        'Aanbevolen hotels',
+        'Modellen',
+    )),
+    "en-AU": ("English (Australia)", (
+        'Brands',
+        'Amenities',
+        'Styles',
+        'Types',
+        'Destinations',
+        'Services',
+        'Courses',
+        'Neighbourhoods',
+        'Shows',
+        'Insurance coverage',
+        'Degree programmes',
+        'Featured hotels',
+        'Models',
+    )),
+    "en-GB": ("English (UK)", (
+        'Brands',
+        'Amenities',
+        'Styles',
+        'Types',
+        'Destinations',
+        'Services',
+        'Courses',
+        'Neighbourhoods',
+        'Shows',
+        'Insurance coverage',
+        'Degree programmes',
+        'Featured hotels',
+        'Models',
+    )),
+    "et": ("Estonian", (
+        'Brändid',
+        'Mugavusteenused',
+        'Stiilid',
+        'Tüübid',
+        'Sihtkohad',
+        'Teenused',
+        'Kursused',
+        'Ümbruskonnad',
+        'Saated ja etendused',
+        'Kindlustuskaitse',
+        'Kraadiõppeprogrammid',
+        'Soovitatud hotellid',
+        'Mudelid',
+    )),
+    "fil": ("Filipino", (
+        'Mga Brand',
+        'Mga Amenity',
+        'Mga Istilo',
+        'Mga Uri',
+        'Mga Destinasyon',
+        'Mga Serbisyo',
+        'Mga Kurso',
+        'Mga Komunidad',
+        'Mga Palabas',
+        'Sakop ng insurance',
+        'Mga degree program',
+        'Itinatampok na hotel',
+        'Mga Modelo',
+    )),
+    "fi": ("Finnish", (
+        'Brändit',
+        'Lisäpalvelut',
+        'Tyylit',
+        'Tyypit',
+        'Kohteet',
+        'Palvelut',
+        'Kurssit',
+        'Kaupunginosat',
+        "Show't",
+        'Vakuutukset',
+        'Oppiaineet',
+        'Suositellut hotellit',
+        'Automerkit',
+    )),
+    "fr": ("French (France)", (
+        'Marques',
+        'Équipements',
+        'Styles',
+        'Types',
+        'Destinations',
+        'Services',
+        'Cours',
+        'Quartiers',
+        'Émissions',
+        "Couverture d'assurance",
+        "Programmes d'études",
+        "Sélection d'hôtels",
+        'Modèles',
+    )),
+    "de": ("German", (
+        'Marken',
+        'Ausstattung',
+        'Stile',
+        'Typen',
+        'Ziele',
+        'Dienstleistungen',
+        'Kurse',
+        'Viertel',
+        'Serien',
+        'Versicherungsleistung',
+        'Studiengänge',
+        'Vorgestellte Hotels',
+        'Modelle',
+    )),
+    "el": ("Greek", (
+        'Επωνυμίες',
+        'Παροχές',
+        'Στυλ',
+        'Τύποι',
+        'Προορισμοί',
+        'Υπηρεσίες',
+        'Μαθήματα',
+        'Γειτονιές',
+        'Εκπομπές',
+        'Ασφαλιστική κάλυψη',
+        'Προγράμματα πτυχίων',
+        'Ξενοδοχεία',
+        'Μοντέλα',
+    )),
+    "iw": ("Hebrew", (
+        'מותגים',
+        'שירותי המקום',
+        'סגנונות',
+        'סוגים',
+        'יעדים גיאוגרפיים',
+        'שירותים',
+        'קורסים',
+        'שכונות',
+        'הופעות ותוכניות',
+        'כיסוי ביטוחי',
+        'תוכניות ללימודי תואר',
+        'מלונות מומלצים',
+        'דגמים',
+    )),
+    "hi": ("Hindi", (
+        'ब्रांड',
+        'सुविधाएं',
+        'शैलियां',
+        'प्रकार',
+        'गंतव्य',
+        'सेवाएं',
+        'पाठ्\u200dयक्रम',
+        'आस-पड़ोस',
+        'शो',
+        'बीमा कवरेज',
+        'डिग्री कार्यक्रम',
+        'प्रदर्शित होटल',
+        'मॉडल',
+    )),
+    "hu": ("Hungarian", (
+        'Márkák',
+        'Szolgáltatások',
+        'Stílusok',
+        'Típusok',
+        'Úti célok',
+        'Szolgáltatások',
+        'Tanfolyamok',
+        'Városrészek',
+        'Műsorok',
+        'Biztosítási módozat',
+        'Diplomaprogramok',
+        'Kiemelt szállodák',
+        'Modellek',
+    )),
+    "id": ("Indonesian", (
+        'Merek',
+        'Fasilitas',
+        'Gaya',
+        'Jenis',
+        'Destinasi',
+        'Layanan',
+        'Mata pelajaran',
+        'Kawasan',
+        'Acara',
+        'Cakupan asuransi',
+        'Program sarjana',
+        'Hotel pilihan',
+        'Model',
+    )),
+    "it": ("Italian", (
+        'Brand',
+        'Servizi',
+        'Stili',
+        'Tipi',
+        'Destinazioni',
+        'Servizi',
+        'Corsi',
+        'Quartieri',
+        'Programmi',
+        'Coperture assicurativa',
+        'Corsi di laurea',
+        'Hotel consigliati',
+        'Modelli',
+    )),
+    "ja": ("Japanese", (
+        'ブランド',
+        '設備',
+        'スタイル',
+        'タイプ',
+        '到着地',
+        'サービス',
+        'コース',
+        '周辺地域',
+        '番組',
+        '保険の保障',
+        '学位プログラム',
+        'おすすめのホテル',
+        'モデル',
+    )),
+    "ko": ("Korean", (
+        '브랜드',
+        '편의 시설',
+        '스타일',
+        '유형',
+        '목적지',
+        '서비스',
+        '과정',
+        '인근 지역',
+        '프로그램',
+        '보험 보상 범위',
+        '학위 취득 프로그램',
+        '추천 호텔',
+        '모델',
+    )),
+    "lv": ("Latvian", (
+        'Zīmoli',
+        'Ērtības',
+        'Stili',
+        'Veidi',
+        'Galamērķi',
+        'Pakalpojumi',
+        'Kursi',
+        'Apkaimes',
+        'Pārraides',
+        'Apdrošināšana',
+        'Studiju programmas',
+        'Piedāvātās viesnīcas',
+        'Modeļi',
+    )),
+    "lt": ("Lithuanian", (
+        'Prekių ženklai',
+        'Patogumai',
+        'Stiliai',
+        'Tipai',
+        'Paskirties vietos',
+        'Paslaugos',
+        'Kursai',
+        'Namų apylinkės',
+        'Laidos',
+        'Draudimo aprėptis',
+        'Moksliniai laipsniai',
+        'Siūlomi viešbučiai',
+        'Modeliai',
+    )),
+    "ms": ("Malay", (
+        'Jenama',
+        'Kemudahan',
+        'Gaya',
+        'Jenis',
+        'Destinasi',
+        'Perkhidmatan',
+        'Kursus',
+        'Kejiranan',
+        'Rancangan',
+        'Liputan insurans',
+        'Program ijazah',
+        'Hotel ditampilkan',
+        'Model',
+    )),
+    "no": ("Norwegian", (
+        'Merkevarer',
+        'Fasiliteter',
+        'Stiler',
+        'Typer',
+        'Destinasjoner',
+        'Tjenester',
+        'Kurs',
+        'Lokalområder',
+        'Programmer',
+        'Forsikringsdekning',
+        'Utdanningsprogrammer',
+        'Utvalgte hoteller',
+        'Modeller',
+    )),
+    "pl": ("Polish", (
+        'Marki',
+        'Udogodnienia',
+        'Style',
+        'Typy',
+        'Miejsca',
+        'Usługi',
+        'Kursy',
+        'Dzielnice',
+        'Programy',
+        'Ubezpieczenia',
+        'Kierunki studiów',
+        'Polecane hotele',
+        'Modele',
+    )),
+    "pt-BR": ("Portuguese (Brazil)", (
+        'Marcas',
+        'Comodidades',
+        'Estilos',
+        'Tipos',
+        'Destinos',
+        'Serviços',
+        'Cursos',
+        'Bairros',
+        'Programas',
+        'Cobertura do seguro',
+        'Programas de graduação',
+        'Hotéis em destaque',
+        'Modelos',
+    )),
+    "pt-PT": ("Portuguese (Portugal)", (
+        'Marcas',
+        'Comodidades',
+        'Estilos',
+        'Tipos',
+        'Destinos',
+        'Serviços',
+        'Cursos',
+        'Arredores',
+        'Programas',
+        'Cobertura do seguro',
+        'Licenciaturas',
+        'Hotéis em destaque',
+        'Modelos',
+    )),
+    "ro": ("Romanian", (
+        'Mărci',
+        'Dotări',
+        'Stiluri',
+        'Tipuri',
+        'Destinații',
+        'Servicii',
+        'Cursuri',
+        'Cartiere',
+        'Emisiuni',
+        'Asigurare',
+        'Programe de studiu',
+        'Hoteluri prezentate',
+        'Modele',
+    )),
+    "ru": ("Russian", (
+        'Бренды',
+        'Удобства',
+        'Стили',
+        'Типы',
+        'Места',
+        'Услуги',
+        'Курсы',
+        'Районы',
+        'Шоу',
+        'Страховая защита',
+        'Программы высшего образования',
+        'Рекомендуемые отели',
+        'Модели',
+    )),
+    "sr": ("Serbian", (
+        'брендови',
+        'садржаји',
+        'стилови',
+        'типови',
+        'дестинације',
+        'услуге',
+        'курсеви',
+        'делови града',
+        'емисије',
+        'осигурање',
+        'дипломе',
+        'истакнути хотели',
+        'модели',
+    )),
+    "sk": ("Slovak", (
+        'Značky',
+        'Vybavenie',
+        'Štýly',
+        'Typy',
+        'Destinácie',
+        'Služby',
+        'Kurzy',
+        'Štvrte',
+        'Relácie',
+        'Poistenie',
+        'Vzdelávacie programy',
+        'Odporúčané hotely',
+        'Modely',
+    )),
+    "sl": ("Slovenian", (
+        'Blagovne znamke',
+        'Ponudba',
+        'Slogi',
+        'Vrste',
+        'Cilji',
+        'Storitve',
+        'Tečaji',
+        'Soseske',
+        'Oddaje',
+        'Kritje zavarovanj',
+        'Študijski programi',
+        'Predstavljeni hoteli',
+        'Modeli',
+    )),
+    "es-419": ("Spanish (Latin America)", (
+        'Marcas',
+        'Servicios adicionales',
+        'Estilos',
+        'Tipos',
+        'Destinos',
+        'Servicios',
+        'Cursos',
+        'Barrios',
+        'Programas',
+        'Cobertura de seguro',
+        'Carreras universitarias',
+        'Hoteles destacados',
+        'Modelos',
+    )),
+    "es": ("Spanish (Spain)", (
+        'Marcas',
+        'Servicios adicionales',
+        'Estilos',
+        'Tipos',
+        'Destinos',
+        'Servicios',
+        'Cursos',
+        '',
+        'Espectáculos',
+        'Cobertura de seguro',
+        'Carreras universitarias',
+        'Hoteles destacados',
+        'Modelos',
+    )),
+    "sv": ("Swedish", (
+        'Varumärken',
+        'Faciliteter',
+        'Stilar',
+        'Typer',
+        'Resmål',
+        'Tjänster',
+        'Kurser',
+        'Barrios',
+        'Program',
+        'Försäkringstyper',
+        'Utbildningsprogram',
+        'Utvalda hotell',
+        'Modeller',
+    )),
+    "th": ("Thai", (
+        'แบรนด์',
+        'สิ่งอำนวยความสะดวก',
+        'สไตล์',
+        'ประเภท',
+        'ปลายทาง',
+        'บริการ',
+        'หลักสูตร',
+        'ย่านใกล้เคียง',
+        'โชว์',
+        'ความคุ้มครองในประกัน',
+        'หลักสูตรปริญญา',
+        'โรงแรมเด่น',
+        'รุ่น',
+    )),
+    "tr": ("Turkish", (
+        'Markalar',
+        'Sunulan olanaklar',
+        'Stiller',
+        'Türler',
+        'destinasyonlar',
+        'Hizmetler',
+        'Kurslar',
+        'Mahalleler',
+        'Programlar',
+        'Sigorta kapsamı',
+        'Lisans programları',
+        'Öne çıkan oteller',
+        'Modeller',
+    )),
+    "uk": ("Ukrainian", (
+        'Бренди',
+        'Зручності',
+        'Стилі',
+        'Типи',
+        'Місця',
+        'Послуги',
+        'Курси',
+        'Квартали',
+        'Шоу',
+        'Страховий захист',
+        'Освітні програми',
+        'Рекомендовані готелі',
+        'Моделі',
+    )),
+    "vi": ("Vietnamese", (
+        'Thương hiệu',
+        'Tiện nghi',
+        'Kiểu',
+        'Loại',
+        'Điểm đến',
+        'Dịch vụ',
+        'Khóa học',
+        'Vùng lân cận',
+        'Chương trình',
+        'Phạm vi bảo hiểm',
+        'Cấp bằng',
+        'Khách sạn nổi bật',
+        'Model',
+    )),
+}
+
+
+ALL_HEADERS = frozenset(ENGLISH_HEADERS) | frozenset(
+    header for _language, headers in LOCALIZED_HEADERS.values() for header in headers if header
+)
+
+# casefolded header -> a spelling Google lists. Only a fallback: two listed
+# headers differ by case alone ("Featured Hotels" / en-GB "Featured hotels",
+# Bulgarian "Модели" / Serbian "модели"), so an exact match always wins.
+_CASEFOLDED: dict[str, str] = {}
+for _header in sorted(ALL_HEADERS, key=lambda h: (h not in ENGLISH_HEADERS, h)):
+    _CASEFOLDED.setdefault(_header.casefold(), _header)
+
+
+def canonical_header(header: str) -> str | None:
+    """The listed spelling of ``header`` (exact first, then any case), or None."""
+    header = (header or "").strip()
+    if header in ALL_HEADERS:
+        return header
+    return _CASEFOLDED.get(header.casefold())
+
+
+def english_header(header: str) -> str | None:
+    """The English header a listed header translates (``"Typen"`` -> ``"Types"``)."""
+    canonical = canonical_header(header)
+    if canonical is None:
+        return None
+    if canonical in ENGLISH_HEADERS:
+        return canonical
+    for _language, headers in LOCALIZED_HEADERS.values():
+        if canonical in headers:
+            return ENGLISH_HEADERS[headers.index(canonical)]
+    return None

{adloop-0.34.0 → adloop-0.34.1}/src/adloop/ads/write.py

@@ -16,22 +16,6 @@ if TYPE_CHECKING:
     from adloop.config import AdLoopConfig
 
 
-_STRUCTURED_SNIPPET_HEADERS = {
-    "Amenities",
-    "Brands",
-    "Courses",
-    "Degree programs",
-    "Destinations",
-    "Featured Hotels",
-    "Insurance coverage",
-    "Models",
-    "Neighborhoods",
-    "Services",
-    "Shows",
-    "Styles",
-    "Types",
-}
-
 _VALID_IMAGE_MIME_TYPES = {
     "image/gif": "IMAGE_GIF",
     "image/jpeg": "IMAGE_JPEG",

{adloop-0.34.0 → adloop-0.34.1}/src/adloop/rules/adloop.md

@@ -287,7 +287,7 @@ Conversions that happen offline (a sales call, a lead that turned into a deal) g
 | `update_ad_group` | Update ad group name and/or MANUAL_CPC `max_cpc` | `ad_group_id`, optional `ad_group_name`, optional `max_cpc` |
 | `draft_responsive_search_ad` | Create RSA preview (does NOT publish) | 3-15 headlines (≤30 chars), 2-4 descriptions (≤90 chars), final_url required, path1/path2 (≤15 chars each). Each headline/description may be a plain string (unpinned) or `{"text": "...", "pinned_field": "HEADLINE_1"}` (pinned). Valid pin slots: `HEADLINE_1/2/3`, `DESCRIPTION_1/2`. Several assets may pin to one slot (they rotate there), but every slot must stay fillable: by an asset pinned to it or by a distinct unpinned asset. |
 | `draft_callouts` | Create callout assets for an ad group, a campaign or the account (does NOT publish) | `campaign_id` or `ad_group_id` (the scope follows the id), or `scope="account"`; `callouts` list with 1-25 chars each |
-| `draft_structured_snippets` | Create structured snippet assets for an ad group, a campaign or the account (does NOT publish) | `campaign_id` or `ad_group_id`, or `scope="account"`; `snippets` list of `{header, values}` with official header values and 3-10 values |
+| `draft_structured_snippets` | Create structured snippet assets for an ad group, a campaign or the account (does NOT publish) | `campaign_id` or `ad_group_id`, or `scope="account"`; `snippets` list of `{header, values}`: an official header in the language of the values (English `Types`, or Google's translation such as German `Typen`) and 3-10 values |
 | `draft_business_name_asset` | Create the business name shown with the ads, for a campaign or the account | `business_name` (≤25), `campaign_id` or `scope="account"` |
 | `link_asset_to_customer` | Link EXISTING assets account-wide (CustomerAsset) | `links`: `{asset_id, field_type}` (CALLOUT, SITELINK, STRUCTURED_SNIPPET, CALL, PRICE, PROMOTION, BUSINESS_NAME, BUSINESS_LOGO, MOBILE_APP, HOTEL_CALLOUT); type is checked |
 | `update_callout` / `update_sitelink` / `update_structured_snippet` | Edit an existing asset IN PLACE: it keeps its ID and history and changes everywhere it is linked | `asset_id` plus the new values (sitelink: only the fields passed; snippet: the full `values` list, empty `header` keeps it) |

{adloop-0.34.0 → adloop-0.34.1}/src/adloop/server.py

@@ -4239,10 +4239,13 @@ def draft_structured_snippets(
 
     Args:
         snippets: At least one dict with "header" and "values". header is one of
-            Amenities, Brands, Courses, Degree programs, Destinations, Featured
-            Hotels, Insurance coverage, Models, Neighborhoods, Services, Shows,
-            Styles, Types (exact spelling). values is a list of 3-10 non-empty
-            strings, each at most 25 characters.
+            Google's snippet headers, in the language of the values: Amenities,
+            Brands, Courses, Degree programs, Destinations, Featured Hotels,
+            Insurance coverage, Models, Neighborhoods, Services, Shows, Styles,
+            Types, or Google's translation of one (German: Typen, Marken,
+            Dienstleistungen, Modelle, Kurse, ...; case does not matter).
+            values is a list of 3-10 non-empty strings, each at most 25
+            characters.
         campaign_id: Numeric ID of the campaign to link the snippets to.
         ad_group_id: Numeric ID of the ad group to link them to, instead of a
             campaign.
@@ -4412,8 +4415,9 @@ def update_structured_snippet(
         asset_id: Numeric ID of the structured snippet asset.
         values: The complete new list of 3-10 values, each at most 25
             characters.
-        header: New header (same list as draft_structured_snippets); empty
-            keeps the current one.
+        header: New header (English or translated, as in
+            draft_structured_snippets); empty keeps the current one as Google
+            stores it, whatever its language.
         customer_id: Google Ads customer ID (digits, dashes optional). Defaults to
             the configured account.
     """