معرّف العميل هو الأرقام العشرة التي تستخدمها Google لتسمية حساب إعلاني واحد — يُكتب 123-456-7890 في شاشات Google Ads، و1234567890 في كل موضع تقبله فيه واجهة API. وكل استدعاء هنا يسمّي حسابًا واحدًا: ما تُعِدّ عنه تقريرًا، وما تقترح فيه تغييرًا، وما ينتمي إليه سجل التغييرات.
الحساب يُسلَّم ولا يُعثر عليه
GET /google-ads/v1/accounts يسرد الحسابات التي يجوز لمؤسستك العمل فيها، وكل استدعاء آخر يقبل قيمة من تلك القيم. أما المعرّف الذي ليس في القائمة فيُجاب عنه كحساب غير موجود — 404 وليس 403، وبالكلمات نفسها في الحالتين، فلا يستطيع أحد أن يميّز حسابًا حقيقيًا لا يجوز لك لمسه عن رقم لا يملكه أحد. لا يمكنك البحث عن حساب، ولا تسمية حساب لم يُسلَّم إليك.
وتقول تلك القائمة أيضًا ما يجوز أن يحدث في كل حساب. may_change بقيمة true تعني أنه يمكن اقتراح تغيير هناك، وfalse تعني أن الحساب لك لتقرأه وتُعِدّ عنه تقارير ولا شيء غير ذلك، وهي النقطة التي يبدأ منها كثير من الحسابات الفعلية ويبقى عندها.
الأرقام العشرة تصلح بالشرطات أو بدونها. تُطبّع الواجهة ما ترسله، وتُجيب بالصيغة ذات الشرطات التي يقرؤها الإنسان.
أسئلة شائعة
كيف يدخل الحساب في تلك القائمة؟
يسلّمه إليك أحد. إما أن يعيّن شريك أحد حساباته المرتبطة لمؤسستك، وإما أن تسمّي مؤسستك حسابًا خاصًا بها وتطلب أن يتولّاه متخصصون — وفي الحالتين تُقبل الدعوة داخل Google Ads من مالك الحساب.
هل يستطيع الوكيل تخمين معرّف؟
يستطيع أن يرسل أي أرقام عشرة يشاء، وسيُقال له إن الحساب غير موجود، وهو الجواب نفسه عن رقم لم يستخدمه أحد قط. لا شيء يُتعلَّم من المحاولة.
حساب واحد أم عدة حسابات؟
بقدر ما سُلِّم إليك. كل استدعاء يسمّي حسابًا واحدًا، فالمساعد الذي يعمل عبر عدة حسابات يسمّي ببساطة حسابًا مختلفًا في كل مرة.