Azure İletişim Hizmetleri kullanılarak bir telefon numarası için operatör bilgilerini araştırma yapma

Telefon numaraları için operatör bilgilerini aramak için JavaScript için Telefon Numaraları istemci kitaplığını kullanmaya başlayın. Bu telefon numarasıyla iletişim kurmak isteyip istemediğinizi ve nasıl iletişim kuracaklarını belirlemek için operatör bilgilerini kullanın. Paketi yüklemek ve telefon numarasıyla ilgili operatör bilgilerini aramak için bu adımları izleyin.

Uyarı

Bu örneğin kaynak kodunu görüntülemek için bkz. Telefon Numaralarını Yönetme - JavaScript | GitHub.

Önkoşullar

Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
Node.js Etkin LTS (uzun vadeli destek) ve Bakım LTS sürümleri (8.11.1 ve 10.14.1 önerilir).
Etkin bir İletişim Hizmetleri kaynağı ve bağlantı dizesi. İletişim Hizmetleri kaynağı oluşturun.

Önkoşul denetimi

Terminalde veya komut penceresinde komutunu çalıştırarak node --version Node.js yüklenip yüklenmediğini denetleyin.

Kurulum

Arama sorguları göndermek üzere bir ortam ayarlamak için aşağıdaki bölümlerdeki adımları izleyin.

Yeni Node.js Uygulaması oluşturma

Terminalde veya komut penceresinde uygulamanız için yeni bir dizin oluşturun ve bu dizine gidin.

mkdir number-lookup-quickstart && cd number-lookup-quickstart

Varsayılan ayarlarla bir npm init -y dosyası oluşturmak için komutunu çalıştırın.

npm init -y

Oluşturduğunuz dizinin kökünde number-lookup-quickstart.js adlı bir dosya oluşturun. Aşağıdaki kod parçacığını ekleyin:

async function main() {
    // quickstart code will go here
}

main();

paketini yükleyin

npm install JavaScript için Azure İletişim Hizmetleri Telefon Numaraları istemci kitaplığını yüklemek için komutunu kullanın.

npm install @azure/communication-phone-numbers@1.3.0 --save

seçeneği, --save kitaplığı package.json dosyanıza bağımlılık olarak ekler.

Kod örnekleri

İstemcinin kimliğini doğrulama

PhoneNumbersClient'ı istemci kitaplığından içeri aktarın ve bağlantı dizenizle örneği oluşturun. Bu dize, Azure portaldaki bir Azure İletişim Hizmetleri kaynağından alınabiliyor. Bağlantı dizenizi kodunuzun içine düz metin olarak yerleştirmekten kaçınmak için ortam COMMUNICATION_SERVICES_CONNECTION_STRING değişkeni kullanmanız önerilir. Kaynağınızın bağlantı dizesini yönetmeyi öğrenin.

aşağıdaki kodu number-lookup-quickstart.jsüst kısmına ekleyin:

const { PhoneNumbersClient } = require('@azure/communication-phone-numbers');

// This code retrieves your connection string from an environment variable
const connectionString = process.env['COMMUNICATION_SERVICES_CONNECTION_STRING'];

// Instantiate the phone numbers client
const phoneNumbersClient = new PhoneNumbersClient(connectionString);

Telefon numarası biçimlendirmesini kontrol et

Bir telefon numarasının operatör bilgilerini aramak için, searchOperatorInformation cihazınızdan PhoneNumbersClient numarasını arayın.

let formattingResults = await phoneNumbersClient.searchOperatorInformation([ "<target-phone-number>" ]);

yerine <target-phone-number> aradığınız telefon numarasını yazın. Bu numara genellikle ileti göndermek istediğiniz numaradır.

Uyarı

Telefon numaralarını E.164 uluslararası standart biçiminde (örneğin, +14255550123) sağlayın.

Bir numara için operatör bilgilerini arayın

Bir telefon numarasının operatör bilgilerini aramak için, seçeneğine searchOperatorInformation ileterek PhoneNumbersClient içinden truearayınincludeAdditionalOperatorDetails.

let searchResults = await phoneNumbersClient.searchOperatorInformation([ "<target-phone-number>" ], { "includeAdditionalOperatorDetails": true });

Uyarı

Bu işlevin kullanılması hesabınıza ücret uygulanır.

İşleç bilgilerini kullanma

Artık işleç bilgilerini kullanabilirsiniz. Bu hızlı başlangıç kılavuzu için bazı ayrıntıları konsola yazdırabiliriz.

İlk olarak, sayı biçimiyle ilgili ayrıntıları yazdırabiliriz.

let formatInfo = formattingResults.values[0];
console.log(formatInfo.phoneNumber + " is formatted " + formatInfo.internationalFormat + " internationally, and " + formatInfo.nationalFormat + " nationally");

Ardından, telefon numarası ve operatör hakkındaki ayrıntıları yazdırabiliriz.

let operatorInfo = searchResults.values[0];
console.log(operatorInfo.phoneNumber + " is a " + (operatorInfo.numberType ? operatorInfo.numberType : "unknown") + " number, operated in "
    + operatorInfo.isoCountryCode + " by " + (operatorInfo.operatorDetails.name ? operatorInfo.operatorDetails.name : "an unknown operator"));

Sms gönderip göndermeyeceğini belirlemek için işleç bilgilerini de kullanabilirsiniz. Daha fazla bilgi için bkz. SMS mesajı gönderme.

Kodu çalıştırma

Komutunu kullanarak node uygulamayı terminal veya komut pencerenizden çalıştırın.

node number-lookup-quickstart.js

Örnek kod

Örnek uygulamayı Telefon Numaralarını Yönet - JavaScript | GitHub adresinden indirebilirsiniz.

Telefon numaraları için operatör bilgilerini aramak için C# için Telefon Numaraları istemci kitaplığını kullanmaya başlayın. Bu telefon numarasıyla iletişim kurmak isteyip istemediğinizi ve nasıl iletişim kuracaklarını belirlemek için operatör bilgilerini kullanın. Paketi yüklemek ve telefon numarasıyla ilgili operatör bilgilerini aramak için bu adımları izleyin.

Uyarı

Bu örneğin kaynak kodunu görüntülemek için bkz. Telefon Numaralarını Yönetme - C# | GitHub.

Önkoşullar

Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
İşletim sisteminiz için .NET Core istemci kitaplığının en son sürümü.
Etkin bir İletişim Hizmetleri kaynağı ve bağlantı dizesi. İletişim Hizmetleri kaynağı oluşturun.

Önkoşul denetimi

Terminalde veya komut penceresinde komutunu çalıştırarak dotnet .NET SDK'sının yüklü olup olmadığını denetleyin.

Kurulum

Arama sorguları göndermek üzere bir ortam ayarlamak için aşağıdaki bölümlerdeki adımları izleyin.

Yeni bir C# uygulaması oluşturma

Terminalde veya komut penceresinde komutunu çalıştırarak dotnet new adlı NumberLookupQuickstartyeni bir konsol uygulaması oluşturun. Bu komut, Program.cs tek bir kaynak dosyasıyla basit bir "Merhaba Dünya" C# projesi oluşturur.

dotnet new console -o NumberLookupQuickstart

Dizininizi yeni oluşturulan uygulama klasörüne değiştirin ve komutunu kullanarak dotnet build uygulamanızı derleyin.

cd NumberLookupQuickstart
dotnet build

Geliştirme paketi akışına bağlanma

SDK'nın genel önizleme sürümü bir geliştirme paketi akışında yayımlanır. Geliştirme akışını ekleme işlemini, NuGet CLI'yi kullanarak ve bunu NuGet.Config dosyasına ekleyerek yapabilirsiniz.

nuget sources add -Name "Azure SDK for .NET Dev Feed" -Source "https://pkgs.dev.azure.com/azure-sdk/public/_packaging/azure-sdk-for-net/nuget/v3/index.json"

Geliştirme akışına bağlanmak için daha ayrıntılı bilgiler ve diğer seçenekler katkıda bulunma kılavuzunda bulunabilir.

paketini yükleyin

Uygulama dizinindeyken, aşağıdaki komutu kullanarak .NET paketi için Azure İletişim Hizmetleri PhoneNumbers istemci kitaplığını yükleyin.

dotnet add package Azure.Communication.PhoneNumbers --version 1.3.0

using ad alanını dahil etmek için Program.cs'nin en üstüne bir Azure.Communication yönergesi ekleyin.

using System;
using System.Threading.Tasks;
using Azure.Communication.PhoneNumbers;

Main işlev imzasını asenkron olacak şekilde güncelleyin.

internal class Program
{
    static async Task Main(string[] args)
    {
        ...
    }
}

Kod örnekleri

İstemcinin kimliğini doğrulama

Telefon Numarası istemcilerinin kimliği , Azure portalındaki bir Azure İletişim Hizmetleri kaynağından alınan bağlantı dizesi kullanılarak doğrulanabilir. Bağlantı dizenizi kodunuzun içine düz metin olarak yerleştirmekten kaçınmak için ortam COMMUNICATION_SERVICES_CONNECTION_STRING değişkeni kullanmanız önerilir. Kaynağınızın bağlantı dizesini yönetmeyi öğrenin.

// This code retrieves your connection string from an environment variable.
string? connectionString = Environment.GetEnvironmentVariable("COMMUNICATION_SERVICES_CONNECTION_STRING");

PhoneNumbersClient client = new PhoneNumbersClient(connectionString, new PhoneNumbersClientOptions(PhoneNumbersClientOptions.ServiceVersion.V2024_03_01_Preview));

Telefon Numarası istemcileri, Microsoft Entra kimlik doğrulamasıyla da kimlik doğrulaması yapabilir. Bu seçenekle, AZURE_CLIENT_SECRET, AZURE_CLIENT_IDve AZURE_TENANT_ID ortam değişkenlerinin kimlik doğrulaması için ayarlanması gerekir.

// Get an endpoint to our Azure Communication Services resource.
Uri endpoint = new Uri("<endpoint_url>");
TokenCredential tokenCredential = new DefaultAzureCredential();
client = new PhoneNumbersClient(endpoint, tokenCredential);

Telefon numarası biçimlendirmesini kontrol et

Bir numaranın ulusal ve uluslararası biçimlendirmesini öğrenmek için SearchOperatorInformationAsync üzerinden PhoneNumbersClient numarasını arayın.

OperatorInformationResult formattingResult = await client.SearchOperatorInformationAsync(new[] { "<target-phone-number>" });

yerine <target-phone-number> aradığınız telefon numarasını yazın. Bu numara genellikle ileti göndermek istediğiniz numaradır.

Uyarı

Telefon numaralarını E.164 uluslararası standart biçiminde (örneğin, +14255550123) sağlayın.

Bir numara için operatör bilgilerini arayın

Bir telefon numarasının operatör bilgilerini aramak için, seçeneğine SearchOperatorInformationAsync ileterek PhoneNumbersClient içinden truearayınIncludeAdditionalOperatorDetails.

OperatorInformationResult searchResult = await client.SearchOperatorInformationAsync(new[] { "<target-phone-number>" }, new OperatorInformationOptions() { IncludeAdditionalOperatorDetails = true });

Uyarı

Bu işlevin kullanılması hesabınıza ücret uygulanır.

İşleç bilgilerini kullanma

Artık işleç bilgilerini kullanabilirsiniz. Bu hızlı başlangıç kılavuzu için bazı ayrıntıları konsola yazdırabiliriz.

İlk olarak, sayı biçimiyle ilgili ayrıntıları yazdırabiliriz.

OperatorInformation formattingInfo = formattingResult.Values[0];
Console.WriteLine($"{formattingInfo.PhoneNumber} is formatted {formattingInfo.InternationalFormat} internationally, and {formattingInfo.NationalFormat} nationally");

Ardından, telefon numarası ve operatör hakkındaki ayrıntıları yazdırabiliriz.

OperatorInformation operatorInformation = searchResult.Values[0];
Console.WriteLine($"{operatorInformation.PhoneNumber} is a {operatorInformation.NumberType ?? "unknown"} number, operated in {operatorInformation.IsoCountryCode} by {operatorInformation.OperatorDetails.Name ?? "an unknown operator"}");

Sms gönderip göndermeyeceğini belirlemek için işleç bilgilerini de kullanabilirsiniz. SMS gönderme hakkında daha fazla bilgi için bkz. SMS iletisi gönderme.

Kodu çalıştırma

Komutunu kullanarak dotnet run uygulamayı terminal veya komut pencerenizden çalıştırın.

dotnet run --interactive

Örnek kod

Örnek uygulamayı Telefon Numaralarını Yönet - C# | GitHub'dan indirebilirsiniz.

Telefon numaraları için operatör bilgilerini aramak üzere Java için Telefon Numaraları istemci kitaplığını kullanmaya başlayın. Bu telefon numarasıyla iletişim kurmak isteyip istemediğinizi ve nasıl iletişim kuracaklarını belirlemek için operatör bilgilerini kullanın. Paketi yüklemek ve telefon numarasıyla ilgili operatör bilgilerini aramak için bu adımları izleyin.

Uyarı

Bu örneğin kaynak kodunu görüntülemek için bkz. Telefon Numaralarını Yönetme - Java | GitHub.

Önkoşullar

Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
Java Development Kit (JDK) sürüm 8 veya üzeri.
Apache Maven.
Etkin bir İletişim Hizmetleri kaynağı ve bağlantı dizesi. İletişim Hizmetleri kaynağı oluşturun.

Önkoşul denetimi

Maven'in yüklü olup olmadığını denetlemek için terminalde veya komut penceresinde komutunu çalıştırın mvn -v .

Kurulum

Arama sorguları göndermek üzere bir ortam ayarlamak için aşağıdaki bölümlerdeki adımları izleyin.

Yeni java uygulaması oluşturma

Terminalde veya komut penceresinde Java uygulamanızı oluşturmak istediğiniz dizine gidin. Maven-archetype-quickstart şablonundan Java projesi oluşturmak için aşağıdaki komutu çalıştırın.

mvn archetype:generate -DgroupId=com.communication.lookup.quickstart -DartifactId=communication-lookup-quickstart -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4 -DinteractiveMode=false

'Oluşturma' görevi, artifactId ile aynı ada sahip bir dizin oluşturur. Bu dizin altında, src/main/java dizini proje kaynak kodunu içerir, src/test/java directory test kaynağını içerir ve pom.xml dosya projenin Proje Nesne Modeli veya POM'dir.

Geliştirme paketi akışına bağlanma

SDK'nın genel önizleme sürümü bir geliştirme paketi akışında yayımlanır. Geliştirme akışına bağlanmak için, metin düzenleyicinizde pom.xml dosyasını açın ve geliştirme deposunu, eğer henüz yoksa ekleyebileceğiniz pom.xml dosyanızın hem hem de <repositories> bölümlerine ekleyin.

<repository>
  <id>azure-sdk-for-java</id>
  <url>https://pkgs.dev.azure.com/azure-sdk/public/_packaging/azure-sdk-for-java/maven/v1</url>
  <releases>
    <enabled>true</enabled>
  </releases>
  <snapshots>
    <enabled>true</enabled>
  </snapshots>
</repository>

settings.xml dosyasını ${user.home}/.m2 içinde eklemeniz veya düzenlemeniz gerekebilir.

<server>
  <id>azure-sdk-for-java</id>
  <username>azure-sdk</username>
  <password>[PERSONAL_ACCESS_TOKEN]</password>
</server>

Kapsamlarında paketleme okuma ve yazma izinleri olan bir kişisel erişim belirteci oluşturabilir ve <password> etiketine yapıştırabilirsiniz.

Geliştirme akışına bağlanmak için daha ayrıntılı bilgiler ve diğer seçenekler burada bulunabilir.

paketini yükleyin

aşağıdaki bağımlılık öğelerini pom.xml dosyasındaki bağımlılık grubuna ekleyin.

<dependencies>
  <dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-communication-common</artifactId>
    <version>1.0.0</version>
  </dependency>

  <dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-communication-phonenumbers</artifactId>
    <version>1.2.0</version>
  </dependency>

  <dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-identity</artifactId>
    <version>1.2.3</version>
  </dependency>

  <dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-core</artifactId>
    <version>1.41.0</version>
  </dependency>
</dependencies>

properties Projenizin Maven sürüm 1.8 veya üzerini hedeflediğinden emin olmak için bölümüne bakın.

<properties>
  <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  <maven.compiler.source>1.8</maven.compiler.source>
  <maven.compiler.target>1.8</maven.compiler.target>
</properties>

Kod örnekleri

Uygulama çerçevesini ayarlama

Proje dizininden:

/src/main/java/com/communication/lookup/quickstart dizinine gidin
App.java dosyasını düzenleyicinizde açma
System.out.println("Hello world!"); ifadesini değiştir
import yönergeleri ekle

Başlamak için aşağıdaki kodu kullanın:

package com.communication.lookup.quickstart;

import com.azure.communication.phonenumbers.*;
import com.azure.communication.phonenumbers.models.*;
import com.azure.core.http.rest.*;
import com.azure.core.util.Context;
import com.azure.identity.*;
import java.io.*;
import java.util.ArrayList;

public class App
{
    public static void main( String[] args ) throws IOException
    {
        System.out.println("Azure Communication Services - Number Lookup Quickstart");
        // Quickstart code goes here
    }
}

İstemcinin kimliğini doğrulama

İstemcinin kimliği, Azure portalındaki bir Azure İletişim Hizmetleri kaynağından alınan bir bağlantı dizesi kullanılarak doğrulanabilir. Bağlantı dizenizi kodunuzun içine düz metin olarak yerleştirmekten kaçınmak için ortam COMMUNICATION_SERVICES_CONNECTION_STRING değişkeni kullanmanız önerilir. Kaynağınızın bağlantı dizesini yönetmeyi öğrenin.

// This code retrieves your connection string from an environment variable
String connectionString = System.getenv("COMMUNICATION_SERVICES_CONNECTION_STRING");

PhoneNumbersClient phoneNumberClient = new PhoneNumbersClientBuilder()
    .connectionString(connectionString)
    .buildClient();

Alternatif olarak, Microsoft Entra kimlik doğrulamasını kullanarak kimlik doğrulaması yapabilirsiniz. DefaultAzureCredentialBuilder kullanmak, Microsoft Entra ID kullanmaya başlamanın en kolay yoludur. Kaynak adınızı Azure portaldaki bir Azure İletişim Hizmetleri kaynağından alabilirsiniz.

// You can find your resource name from your resource in the Azure portal
String endpoint = "https://<RESOURCE_NAME>.communication.azure.com";

PhoneNumbersClient phoneNumberClient = new PhoneNumbersClientBuilder()
    .endpoint(endpoint)
    .credential(new DefaultAzureCredentialBuilder().build())
    .buildClient();

Telefon numarası biçimlendirmesini kontrol et

Bir numaranın ulusal ve uluslararası biçimlendirmesini öğrenmek için searchOperatorInformation üzerinden PhoneNumbersClient numarasını arayın.

ArrayList<String> phoneNumbers = new ArrayList<String>();
phoneNumbers.add("<target-phone-number>");

// Use the free number lookup functionality to get number formatting information
OperatorInformationResult formattingResult = phoneNumberClient.searchOperatorInformation(phoneNumbers);
OperatorInformation formattingInfo = formattingResult.getValues().get(0);

yerine <target-phone-number> aradığınız telefon numarasını yazın. Bu numara genellikle ileti göndermek istediğiniz numaradır.

Uyarı

Telefon numaralarını E.164 uluslararası standart biçiminde (örneğin, +14255550123) sağlayın.

Bir numara için operatör bilgilerini arayın

Bir telefon numarasının operatör bilgilerini aramak için, seçeneğine searchOperatorInformationWithResponse ileterek PhoneNumbersClient içinden truearayınIncludeAdditionalOperatorDetails.

OperatorInformationOptions options = new OperatorInformationOptions();
options.setIncludeAdditionalOperatorDetails(true);
Response<OperatorInformationResult> result = phoneNumberClient.searchOperatorInformationWithResponse(phoneNumbers, options, Context.NONE);
OperatorInformation operatorInfo = result.getValue().getValues().get(0);

Uyarı

Bu işlevin kullanılması hesabınıza ücret uygulanır.

İşleç bilgilerini kullanma

Artık işleç bilgilerini kullanabilirsiniz. Bu hızlı başlangıç kılavuzu için bazı ayrıntıları konsola yazdırabiliriz.

İlk olarak, sayı biçimiyle ilgili ayrıntıları yazdırabiliriz.

System.out.println(formattingInfo.getPhoneNumber() + " is formatted "
    + formattingInfo.getInternationalFormat() + " internationally, and "
    + formattingInfo.getNationalFormat() + " nationally");

Ardından, telefon numarası ve operatör hakkındaki ayrıntıları yazdırabiliriz.

String numberType = operatorInfo.getNumberType() == null ? "unknown" : operatorInfo.getNumberType().toString();
String operatorName = "an unknown operator";
if (operatorInfo.getOperatorDetails()!= null && operatorInfo.getOperatorDetails().getName() != null)
{
    operatorName = operatorInfo.getOperatorDetails().getName();
}
System.out.println(operatorInfo.getPhoneNumber() + " is a " + numberType + " number, operated in "
    + operatorInfo.getIsoCountryCode() + " by " + operatorName);

Sms gönderip göndermeyeceğini belirlemek için işleç bilgilerini de kullanabilirsiniz. Daha fazla bilgi için bkz. SMS mesajı gönderme.

Kodu çalıştırma

Uygulamayı terminal veya komut pencerenizden aşağıdaki komutlarla çalıştırın: pom.xml dosyasını içeren dizine gidin ve projeyi derleyin.

mvn compile

Ardından paketi derleyin.

mvn package

Uygulamayı yürütmek için komutunu kullanın mvn .

mvn exec:java -D"exec.mainClass"="com.communication.lookup.quickstart.App" -D"exec.cleanupDaemonThreads"="false"

Örnek kod

Örnek uygulamayı buradan indirebilirsiniz: Telefon Numaralarını Yönet - Java | GitHub.

Telefon numaraları için operatör bilgilerini aramak üzere Python için Telefon Numaraları istemci kitaplığını kullanmaya başlayın. Bu telefon numarasıyla iletişim kurmak isteyip istemediğinizi ve nasıl iletişim kuracaklarını belirlemek için operatör bilgilerini kullanın. Paketi yüklemek ve telefon numarasıyla ilgili operatör bilgilerini aramak için bu adımları izleyin.

Uyarı

Bu örneğin kaynak kodunu görüntülemek için bkz. Telefon Numaralarını Yönetme - Python | GitHub.

Önkoşullar

Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
Python 3.7+.
Etkin bir İletişim Hizmetleri kaynağı ve bağlantı dizesi. İletişim Hizmetleri kaynağı oluşturun.

Önkoşul denetimi

Terminalde veya komut penceresinde, Python'ın yüklü olup olmadığını denetlemek için komutunu çalıştırın python --version .

Kurulum

Arama sorguları göndermek üzere bir ortam ayarlamak için aşağıdaki bölümlerdeki adımları izleyin.

Yeni Python uygulaması oluşturma

Terminalde veya komut penceresinde uygulamanız için yeni bir dizin oluşturun ve bu dizine gidin.

mkdir number-lookup-quickstart && cd number-lookup-quickstart

Proje kök dizininde adlı number_lookup_sample.py bir dosya oluşturmak ve aşağıdaki kodu eklemek için bir metin düzenleyicisi kullanın. Kalan hızlı başlangıç kodu aşağıdaki bölümlerde eklenmiştir.

import os
from azure.communication.phonenumbers import PhoneNumbersClient

try:
   print('Azure Communication Services - Number Lookup Quickstart')
   # Quickstart code goes here
except Exception as ex:
   print('Exception:')
   print(ex)

paketini yükleyin

Python paketi için Azure Communication Services PhoneNumbers istemci kitaplığını, uygulama dizinindeyken pip install komutunu kullanarak yükleyin.

pip install azure-communication-phonenumbers==1.2.0

Kod örnekleri

İstemcinin kimliğini doğrulama

# This code retrieves your connection string from an environment variable
connection_string = os.getenv('COMMUNICATION_SERVICES_CONNECTION_STRING')
try:
    phone_numbers_client = PhoneNumbersClient.from_connection_string(connection_string)
except Exception as ex:
    print('Exception:')
    print(ex)

Alternatif olarak, istemcinin kimliği Microsoft Entra kimlik doğrulaması kullanılarak doğrulanabilir. DefaultAzureCredential Nesnesini kullanmak, Microsoft Entra Id kullanmaya başlamanın en kolay yoludur ve komutunu kullanarak pip install yükleyebilirsiniz.

pip install azure-identity

DefaultAzureCredential Nesne oluşturmak için AZURE_CLIENT_ID, AZURE_CLIENT_SECRET, ve AZURE_TENANT_ID zaten kayıtlı Microsoft Entra uygulamanızdan karşılık gelen değerleriyle ortam değişkenleri olarak ayarlamanız gerekir.

Bu ortam değişkenlerini alma hakkında bilgi edinmek için CLI'dan hizmet sorumlularını ayarlamayı öğrenebilirsiniz.

azure-identity Kitaplık yüklendikten sonra istemcinin kimliğini doğrulamaya devam edebilirsiniz.

from azure.identity import DefaultAzureCredential

# You can find your endpoint from your resource in the Azure portal
endpoint = 'https://<RESOURCE_NAME>.communication.azure.com'
try:
    credential = DefaultAzureCredential()
    phone_numbers_client = PhoneNumbersClient(endpoint, credential)
except Exception as ex:
    print('Exception:')
    print(ex)

Telefon numarası biçimlendirmesini kontrol et

Bir numaranın ulusal ve uluslararası biçimlendirmesini öğrenmek için search_operator_information üzerinden PhoneNumbersClient numarasını arayın.

formatting_results = phone_numbers_client.search_operator_information("<target-phone-number>")

yerine <target-phone-number> aradığınız telefon numarasını yazın. Bu numara genellikle ileti göndermek istediğiniz numaradır.

Uyarı

Telefon numaralarını E.164 uluslararası standart biçiminde (örneğin, +14255550123) sağlayın.

Bir numara için operatör bilgilerini arayın

Bir telefon numarasının operatör bilgilerini aramak için, seçeneğine search_operator_information ileterek PhoneNumbersClient içinden Truearayıninclude_additional_operator_details.

options = { "include_additional_operator_details": True }
operator_results = phone_numbers_client.search_operator_information("<target-phone-number>", options=options)

Uyarı

Bu işlevin kullanılması hesabınıza ücret uygulanır.

İşleç bilgilerini kullanma

Artık işleç bilgilerini kullanabilirsiniz. Bu hızlı başlangıç kılavuzu için bazı ayrıntıları konsola yazdırabiliriz.

İlk olarak, sayı biçimiyle ilgili ayrıntıları yazdırabiliriz.

formatting_info = formatting_results.values[0]
print(str.format("{0} is formatted {1} internationally, and {2} nationally", formatting_info.phone_number, formatting_info.international_format, formatting_info.national_format))

Ardından, telefon numarası ve operatör hakkındaki ayrıntıları yazdırabiliriz.

operator_information = operator_results.values[0]

number_type = operator_information.number_type if operator_information.number_type else "unknown"
if operator_information.operator_details is None or operator_information.operator_details.name is None:
    operator_name = "an unknown operator"
else:
    operator_name = operator_information.operator_details.name

print(str.format("{0} is a {1} number, operated in {2} by {3}", operator_information.phone_number, number_type, operator_information.iso_country_code, operator_name))

Sms gönderip göndermeyeceğini belirlemek için işleç bilgilerini de kullanabilirsiniz. SMS gönderme hakkında daha fazla bilgi için bkz. SMS iletisi gönderme.

Kodu çalıştırma

Komutunu kullanarak python uygulamayı terminal veya komut pencerenizden çalıştırın.

python number_lookup_sample.py

Örnek kod

Örnek uygulamayı Telefon Numaralarını Yönet - Python | sayfasından indirebilirsiniz GitHub.

Sorun giderme

Sık sorulan sorular ve sorunlar:

Ortam değişkenlerinde yapılan değişiklikler zaten çalışmakta olan programlarda etkili olmayabilir. Ortam değişkenlerinizin beklendiği gibi çalışmadiğini fark ederseniz, kodu çalıştırmak ve düzenlemek için kullandığınız tüm programları kapatıp yeniden açmayı deneyin.
Bu uç nokta tarafından döndürülen veriler çeşitli uluslararası yasalara ve düzenlemelere tabidir, bu nedenle sonuçların doğruluğu çeşitli faktörlere bağlıdır. Bu faktörler arasında numaranın taşınabilir olup olmadığı, ülke kodu ve çağıranın onay durumu yer alır. Bu faktörlere bağlı olarak, bazı telefon numaraları için operatör bilgileri kullanılamayabilir veya geçerli operatörü değil telefon numarasının orijinal operatörünü yansıtabilir.

Sonraki adımlar

Bu makalede şunların nasıl yapıldığını açıklanmıştır:

Sayı biçimlendirmesini kontrol et.
Telefon numarası için operatör bilgilerini arama

Sayı Arama Kavramı

Numara Arama SDK'sı

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2025-10-08

Aracılığıyla paylaş

Azure İletişim Hizmetleri kullanılarak bir telefon numarası için operatör bilgilerini araştırma yapma

Önkoşullar

Önkoşul denetimi

Kurulum

Yeni Node.js Uygulaması oluşturma

paketini yükleyin

Kod örnekleri

İstemcinin kimliğini doğrulama

Telefon numarası biçimlendirmesini kontrol et

Bir numara için operatör bilgilerini arayın

İşleç bilgilerini kullanma

Kodu çalıştırma

Örnek kod

Önkoşullar

Önkoşul denetimi

Kurulum

Yeni bir C# uygulaması oluşturma

Geliştirme paketi akışına bağlanma

paketini yükleyin

Kod örnekleri

İstemcinin kimliğini doğrulama

Telefon numarası biçimlendirmesini kontrol et

Bir numara için operatör bilgilerini arayın

İşleç bilgilerini kullanma

Kodu çalıştırma

Örnek kod

Önkoşullar

Önkoşul denetimi

Kurulum

Yeni java uygulaması oluşturma

Geliştirme paketi akışına bağlanma

paketini yükleyin

Kod örnekleri

Uygulama çerçevesini ayarlama

İstemcinin kimliğini doğrulama

Telefon numarası biçimlendirmesini kontrol et

Bir numara için operatör bilgilerini arayın

İşleç bilgilerini kullanma

Kodu çalıştırma

Örnek kod

Önkoşullar

Önkoşul denetimi

Kurulum

Yeni Python uygulaması oluşturma

paketini yükleyin

Kod örnekleri

İstemcinin kimliğini doğrulama

Telefon numarası biçimlendirmesini kontrol et

Bir numara için operatör bilgilerini arayın

İşleç bilgilerini kullanma

Kodu çalıştırma

Örnek kod

Sorun giderme

Sonraki adımlar

Geri Bildirim

Ek kaynaklar