login-customer-id
login-customer-id ist ein HTTP-Request-Header in der Google Ads API, der die Kundennummer des Manager-Kontos trägt, durch das Sie handeln, und Google mitteilt, welches Konto in der Hierarchie den Aufruf im Namen des Zielkontos autorisiert.
Jede Google-Ads-API-Anfrage zielt auf eine Kundennummer, das Konto, dessen Kampagnen Sie lesen oder ändern. Wird dieses Konto über ein Manager-Konto (MCC) erreicht, muss die API auch den Weg kennen, den Sie dorthin genommen haben. Das ist die Aufgabe von login-customer-id: Es benennt das Manager-Konto, dessen Autorisierung Sie ausüben, und wird als zehn Ziffern ohne Bindestriche gesendet (1234567890, nicht 123-456-7890).
Die Faustregel: Gehören Ihre OAuth-Zugangsdaten einem Nutzer, der direkt auf das Zielkonto zugreift, können Sie den Header meist weglassen. Kommt der Zugriff über ein Manager-Konto, der Normalfall für Agenturen und für jeden, der ein an ein MCC ausgegebenes Developer-Token nutzt, ist der Header erforderlich. Ihn wegzulassen ist eine der häufigsten Ursachen für USER_PERMISSION_DENIED-Fehler bei Entwicklern, die das Konto in der Weboberfläche einwandfrei sehen, weil die UI dieselbe Auflösung still durchführt, die API aber nicht.
Es gibt eine zweite, subtilere Nutzung. In tiefen Hierarchien entscheidet der Header, welcher Manager-Kontext gilt, und dieser Kontext beeinflusst, was Sie sehen und tun können: Geteilte Budgets, kontenübergreifende Conversion-Aktionen und Einstellungen auf Kontoebene lösen sich alle relativ zum Manager auf, durch den Sie sich angemeldet haben. Das falsche MCC in einer verschachtelten Struktur zu senden kann Teildaten statt eines klaren Fehlers erzeugen, was viel schwerer zu bemerken ist.
Genau diese Art von Verrohrung nimmt Opus Growth ab. Weil wir den Connector als gehosteten Dienst betreiben, wird der Manager-Kontext bei jedem Aufruf für Sie aufgelöst, Sie verbinden sich einmal per Google-Anmeldung und handhaben nie selbst ein Developer-Token, einen Kundennummer-Header oder eine OAuth-Refresh-Schleife.
Häufige Fragen
Immer wenn Sie auf ein Konto über ein Manager-Konto statt direkt zugreifen, was praktisch alle Agentur-Setups und jede Integration mit einem an ein MCC ausgegebenen Developer-Token abdeckt. Konten mit Direktzugriff können ihn meist weglassen.
Am häufigsten USER_PERMISSION_DENIED, manchmal CUSTOMER_NOT_ENABLED oder einen allgemeinen Autorisierungsfehler, obwohl derselbe Nutzer das Konto in der Google-Ads-Weboberfläche normal öffnen kann.
Zehn Ziffern ohne Bindestriche. Ein als 123-456-7890 in der Oberfläche gezeigtes Konto wird als 1234567890 im Header gesendet.